The client CLI

CLI commands

The `client` CLI ships with a health check and the `client clientos` commands of the CRM example: working patterns for your own commands. One page per command.

Generated from the CLI’s own Commander definitions (apps/cli/src/index.ts) and checked against them by this site’s tests. The CLI is not published: build it in the workspace with `pnpm --filter @client/cli build` and run `node apps/cli/dist/index.js <command>`, or `<command> --help` for the same details. The clientos commands need SUPABASE_SERVICE_ROLE_KEY and use CLIENTS_ROOT for Client folders.

scaffold

client health
Check that the API answers: calls /health and prints the JSON reply.

clients

client clientos list-clients
List every active Client with a health summary. Alias: `ls`.
client clientos status <slug>
Show one Client’s health dashboard: tasks, promises and projects.
client clientos init <slug>
Create a new Client: its Client folder on disk and its database record.
client clientos open <slug>
Open the Client folder in Finder.
client clientos add-project <slug>
Add a Project for a Client.

records

client clientos add-task <slug>
Add a task for a Client, interactively.
client clientos edit-task <slug>
Edit one of a Client’s open tasks.
client clientos add-promise <slug>
Record an explicit commitment made to a Client.
client clientos add-note <slug>
Add a freeform Note for a Client.
client clientos add-comm <slug>
Log a communication with a Client: a call, an email, a meeting and so on.
client clientos add-credential <slug>
Store a credential reference: where a secret lives, never the secret itself.
client clientos add-link <slug>
Save a URL for a Client: staging, dashboards, design files and so on.
client clientos add-env <slug>
Add an Environment record: production, staging, dev and so on.

llm-context

client clientos context <slug>
Print a Client’s LLM context to stdout, to pipe to the clipboard or an LLM.
client clientos sync-files <slug>
Sync the Context files in 04-llm-context/ on disk into the database.
client clientos sync-client <slug>
Sync client.yaml and the Context files into the database: name, contacts, tasks, promises.
client clientos bind [slug]
Bind this session to a Client, and optionally a Project, for context capture.