@paean-ai/workers

CLI tool and library for packaging, publishing, and managing Worker packages on the 0.works marketplace.

Workers are agent environment archives — reusable toolkits that coding agents (Claude Code, Cursor, Codex, a8e, etc.) can use to extend their capabilities.

Install

npm install -g @paean-ai/workers

Quick Start

# Initialize a new worker package
workers init

# Edit workers.json with your package metadata
# ...

# Inspect and validate
workers inspect

# Pack locally (dry-run)
workers pack

# Publish to 0.works
export PAEAN_TOKEN="your-api-token"
workers publish

CLI Commands

| Command | Description | |---|---| | workers init | Create workers.json manifest and .workersignore | | workers pack | Create a .zip package (no upload) | | workers publish | Package and publish to 0.works | | workers publish-id <id> | Publish a previously uploaded draft | | workers inspect [dir] | Validate manifest and report stats | | workers list | List your published workers | | workers search [query] | Search the marketplace | | workers info <slug> | Show worker details | | workers versions <slug> | List all versions | | workers unpublish <id> | Remove a published worker |

Manifest (workers.json)

{
  "name": "My Worker",
  "version": "1.0.0",
  "description": "A useful worker for coding agents",
  "shortDescription": "Short tagline",
  "compatibleAgents": ["cursor", "claude-code"],
  "categories": ["coding"],
  "priceType": "free",
  "priceAmount": 0
}

Environment Variables

| Variable | Description | Default | |---|---|---| | PAEAN_TOKEN | API authentication token | (required for publish/list) | | PAEAN_API_URL | API base URL | https://api.paean.ai |

Programmatic Usage

import { packWorker, inspectWorker, WorkersApi } from '@paean-ai/workers';

// Pack a worker directory
const result = packWorker('/path/to/worker');
console.log(result.outputPath, result.size);

// Inspect a worker
const inspection = inspectWorker('/path/to/worker');
console.log(inspection.errors, inspection.warnings);

// Use the API client
const api = new WorkersApi(yourHttpClient);
const workers = await api.list();

License

MIT