Use the ct skill, or read skills/ct/SKILL.md, for comprehensive CLI
documentation.
Read First
docs/development/LOCAL_DEV_SERVERS.md- Local dev setupdocs/common/workflows/development.md- Workflow commands
Find Identity Key
ls -la ./ct.key ./identity.key 2>/dev/null || ls -la *.key 2>/dev/null || find . -name "*.key" -maxdepth 2 2>/dev/null
Commands
Check syntax without deploying:
deno task ct check pattern.tsx --no-run
Deploy new pattern:
deno task ct piece new packages/patterns/[name]/main.tsx --identity PATH_TO_KEY
Inspect piece state:
deno task ct piece inspect
Update deployed pattern:
deno task ct piece setsrc packages/patterns/[name]/main.tsx
Test handler via CLI:
deno task ct piece call handlerName --piece PIECE_ID
deno task ct piece step --piece PIECE_ID # Required! Triggers recomputation
deno task ct piece inspect --piece PIECE_ID # Now shows updated state
Important: Always run piece step after piece call or piece set.
Without it, computed values remain stale and inspect/get return old data.
Get Help
deno task ct --help
deno task ct piece --help
Done When
- Piece deploys without errors
- State inspects correctly
- Handlers respond to CLI calls