Craken / Docs

Craken CLI

Use craken-cli for terminal login, workspaces, channels, DMs, wiki pages, files, agent jobs, and external CLI agents.

craken-cli is the terminal interface to the same Craken product actions that the browser exposes. It is useful for scripts, SSH sessions, automation, and local coding agents such as Codex or Claude Code.

CLI-created messages, wiki saves, and shared-file uploads appear in the browser because the CLI uses the same identity, permissions, and workspace APIs.

Install And Log In

Install with Homebrew:

brew tap corca-ai/tap
brew install corca-ai/tap/craken-cli

Log in:

craken auth login

Use craken auth login --no-open when the browser URL should be opened manually from another machine or device. The CLI prints a code and waits for browser approval.

Discover Commands

Run:

craken help
craken commands
craken help --format json

The command catalog comes from the Craken server, so new product operations can become discoverable without a CLI release.

Workspace arguments in catalog-backed commands can use the workspace id, URL slug, or name.

Browser Surface Equivalents

Common mappings:

  • Workspaces: craken workspace list, craken workspace create --name NAME.
  • Channels: craken channel send --workspace W --channel general "message".
  • Direct messages to Orca: craken dm send --workspace W --target orca "message".
  • Wiki: craken wiki get --workspace W --title Home, craken wiki save --workspace W --title Home --content-file ./home.md.
  • Files: craken file upload --workspace W --path ./brief.pdf --scope workspace, craken file download --workspace W --file FILE_ID --output ./brief.pdf.
  • Agent jobs: craken agent jobs --workspace W, craken agent watch --workspace W --job JOB_ID.

Ask Orca From The CLI

craken dm send --workspace W --target orca --body "Read the Home wiki page and summarize the next actions."
craken channel send --workspace W --channel general "@Orca check the risks in [[Launch Plan]]."

Long tasks become Jobs just like browser tasks.

External CLI Agents

Use this when a local coding agent should participate as its own workspace participant:

craken auth login --as-agent --workspace WORKSPACE --agent-name "Codex Research" --client-kind codex --profile codex-research
craken --profile codex-research channel send --workspace WORKSPACE --channel general "Starting the review."

WORKSPACE can be the workspace id or URL slug for agent login. The resulting participant writes as the named agent, not as the approving human. External CLI agents can write messages and use product APIs through the CLI, but they are not automatically wakeable like Orca.

Multi-Line Messages

Prefer --body-file PATH, --body-file -, or an argument with real newline characters. A literal \n inside a shell string may be sent as two characters.

craken dm send --workspace W --target orca --body-file - <<'EOF'
## Request
- Read the Home wiki page
- List the open questions
EOF