Skip to content

cli.md

Latest commit

 

History

History
93 lines (69 loc) · 3.3 KB

cli.md

File metadata and controls

93 lines (69 loc) · 3.3 KB

CLI reference

Server

b0 server [--host] [--port] [--db]         Start server

Authentication

b0 login <url> --key <key>                 Connect from another machine
b0 logout                                  Disconnect
b0 reset                                   Clean slate (deletes DB, config, skills)
b0 status                                  Show connection info and pending tasks
b0 invite <name>                           Create user (admin only)
b0 admin ensure --name <name> --key <key> Create/update a local admin user

Agents

b0 agent add <name> --instructions "..." [--description "..."] [--workspace <w>] [--runtime auto|claude|codex] [--webhook <url>] [--slack <channel>]
b0 agent ls [--workspace <w>]
b0 agent info <name> [--workspace <w>]
b0 agent update <name> --instructions "..." [--workspace <w>]
b0 agent stop <name> [--workspace <w>]
b0 agent start <name> [--workspace <w>]
b0 agent logs <name> [--workspace <w>]
b0 agent remove <name> [--workspace <w>]

Task delegation

These commands are primarily used by agents, not humans.

b0 delegate <agent> "<task>" [--workspace <w>]       New task (non-blocking)
b0 delegate --thread <id> <agent> "<message>"        Continue conversation
b0 delegate <agent>                                  Read task from stdin
b0 wait [--all] [--timeout <sec>]                    Collect results
b0 reply [--workspace <w>] <thread-id> "<answer>"    Answer an agent's question
b0 threads [--workspace <w>] [--limit <n>]           List recent conversations

How delegation works

  1. b0 delegate sends a task to an agent's inbox and returns immediately with a thread ID.
  2. The daemon picks up the task, spawns a Claude Code or Codex process, and executes it.
  3. b0 wait blocks until a pending task has results, then prints them. Use --all to wait for everything.
  4. For multi-turn conversations, pass --thread <id> to continue an existing conversation. The agent resumes its Claude session with full history.

Cron jobs

b0 cron add --every <interval> "<task>" [--agent <name>] [--workspace <w>] [--webhook <url>] [--slack <channel>] [--until <date>]
b0 cron ls [--workspace <w>]
b0 cron remove <id> [--workspace <w>]
b0 cron enable <id> [--workspace <w>]
b0 cron disable <id> [--workspace <w>]

Intervals: 30s, 5m, 1h, 6h, 1d. Optional end date: 2026-04-24 or 2026-04-24T12:00:00Z.

If --agent is omitted, a temporary agent is auto-created and cleaned up when the cron job is removed.

Webhook triggers

b0 webhook add <agent> [--workspace <w>]             Add webhook trigger to agent
b0 webhook ls <agent> [--workspace <w>]              List webhook triggers for agent
b0 webhook rm <id> [--workspace <w>]                 Remove webhook trigger

An HTTP POST to the returned webhook URL triggers the agent with the request body as the task prompt.

Workspaces

b0 workspace create <name>                 Create workspace
b0 workspace ls                            List your workspaces
b0 workspace add-member <workspace> <user-id>   Add user to workspace

Skills

Skills teach your agent how to use Box0. Install via npx skills:

npx skills add risingwavelabs/skills --skill b0

See Skills for details on what gets installed and how it works.