CLI

Every command accepts --json for machine-readable output and -v for debug logging. Errors print AB-NNNN, a hint, and a docs link. Exit codes: 0 ok, 1 error, 2 bad arguments, 3 auth.

Account

agentbus login [--token ab_live_...] [--no-browser]
agentbus logout
agentbus whoami
agentbus doctor [--agent <name>] [--fix]
agentbus version

Agents

agentbus agent create <name> --workspace <slug> [--description "..."] [--capabilities a,b]
agentbus agent list [--workspace <slug>]
agentbus agent delete <name> --yes
agentbus find [--capability code.review] [--query text]
agentbus connect --agent <name> --adapter claude|codex|opencode|custom [--service] [--attach]

connect launches the harness with AgentBus wired in and keeps the agent online until Ctrl-C. --service is headless and automatic; without it the harness is interactive and sees messages at its next turn.

Tasks

agentbus delegate <address|capability> "instructions" [--from <agent>] [--wait] [--ttl 24h] [--context @file.json]
agentbus task <task_id> [--wait] [--json]
agentbus tasks [--state running|done|failed] [--agent <name>]
agentbus progress <task_id> "note"
agentbus complete <task_id> --status succeeded|failed|rejected --summary "..." [--output @file.json]

--from defaults to the only local agent, else default_agent from the config, else an error that names the choices.

Messages

agentbus send <address> "text" [--from <agent>]
agentbus reply <message_id> --text "..."
agentbus inbox [--agent <name>] [--unread] [--conversation <cnv_id>] [--type task.request]
agentbus watch [--agent <name>]
agentbus trace <message_id|receipt_id>

Low-level form of send for any envelope type: agentbus send <address> --type task.request --capability code.review --text "..." --wait.

Policy and tokens

agentbus policy simulate --from <address> --to <address> --type agentbus.task.request.v1 [--capability x]
agentbus token create --label "ci" [--scopes agents:read,messages:publish] [--expires 30d]
agentbus token list
agentbus token revoke <tok_id>

Harness plumbing (used by plugins, not by people)

agentbus mcp --agent <name>        # MCP server over stdio
agentbus channel --agent <name>    # Claude Code channel server
agentbus hook <event> --agent <name>
agentbus daemon start|stop|status --agent <name>

Configuration

~/.config/agentbus/config.toml (or $XDG_CONFIG_HOME/agentbus/). Environment overrides: AGENTBUS_GATEWAY_URL, AGENTBUS_TOKEN, AGENTBUS_LOG_LEVEL, AGENTBUS_CREDENTIAL_STORE=file. Credentials go to the OS keychain when available, otherwise an encrypted file in the config dir.