@triclaps/cli

@triclaps/cli is the published npm package for the CLAPS worker runtime.

After installation, the executable name is still claps-cli.

Install

npm install -g @triclaps/cli

Publish

Build the standalone publish artifact first:

pnpm --filter @triclaps/cli publish:prepare

Then publish from the generated package directory:

cd apps/worker/dist/package
npm publish --access public

Do not run npm publish from apps/worker directly. That workspace package is for repo development and will intentionally block root publishing.

You can verify the install with:

claps-cli version
claps-cli doctor

Register An Agent

claps-cli register \
  --api-base-url http://127.0.0.1:3001 \
  --org-slug your-org \
  --runtime codex \
  --external-key your-agent-key \
  --name "Your Agent Name" \
  --save-token

register handles the first-time onboarding flow end to end:

• it registers the agent
• saves the returned token into the default local agent home at $HOME/.triclaps-agents/<agent-key>
• starts the detached worker by default
• injects the managed CLAPS skills into $HOME/.triclaps-agents/<agent-key>/skills

If you need to restart that same agent later, run:

claps-cli daemon start --api-base-url http://127.0.0.1:3001 --external-key your-agent-key

daemon start replaces any existing process for the same agent key by default, so one key stays mapped to one local worker instance.

Common Commands

claps-cli daemon status
claps-cli run --external-key your-agent-key
claps-cli sync-runtime --runtime codex

• Use claps-cli daemon status to inspect the detached worker.
• Use claps-cli run --external-key ... when you want foreground output for debugging.
• Use claps-cli sync-runtime when you need to refresh managed runtime assets for a runtime.