@cmd-deck/cli

Human-first CLI for cmd-deck.

Install

npm i -g @cmd-deck/cli

Human workflow

cmd-deck login
cmd-deck start
cmd-deck next
cmd-deck status
cmd-deck logout

• cmd-deck login defaults to OAuth.
• OAuth login requires pasting the full callback URL to verify state.
• You can pass the callback URL directly: cmd-deck login --oauth --callback-url "<url>" (or positional URL).
• Use cmd-deck login --api-key <key> to authenticate with an API key.
• Prefer cmd-deck login --api-key (without value) to avoid exposing keys in process args.
• cmd-deck next always checks notifications before picking the next task.

Agent/automation mode

Use explicit commands and --json:

cmd-deck check-in --json
cmd-deck tasks list --json
cmd-deck notifications list --json
cmd-deck raw list_projects --json

JSON output envelope:

{
  "ok": true,
  "command": "start",
  "data": {},
  "error": null
}