@pstdio/pocketcoder-cli

The operator and diagnostics CLI for PocketCoder.

It gives operators one supported interface to run the server, manage database state and access, validate templates, inspect workspaces, and diagnose a deployment without writing control-plane API calls by hand.

Install

pcd requires Bun 1.3.14 or newer:

bun add --global @pstdio/pocketcoder-cli
pcd --version
pcd --help

Database and administrative commands use POCKETCODER_DATABASE_URL and POCKETCODER_DATABASE_SCHEMA. Workspace and diagnostics commands use POCKETCODER_URL and POCKETCODER_KEY.

The CLI automatically loads the nearest .env file without overriding values already exported by the shell. Use --workdir <directory> to select another project directory or --env-file <path> to load a specific file.

pcd server start|status|stop manages only the PocketCoder server process. It does not build workspace images, generate templates, start a model gateway, or initialize deployment prerequisites.

See the full CLI reference.

Command layout

Each command lives under src/commands/<resource>/<action>.ts. The resource registers its actions with yargs, and each action owns its options and handler. This keeps help scoped to the selected resource or action and lets parseAsync() run the command directly.