Command Reference
Command reference
Every command, grouped by area. Run brainbase help to print this same summary in your terminal.
brainbase <command> [options]
Commands
| Group | Commands | Reference |
|---|---|---|
| Auth | `login` · `logout` · `whoami` | [auth](/cli/commands/auth) |
| Agent | `agent create` · `pull` · `push` · `unpack` · `status` · `env` · `link` · `unlink` · `sync` · `run` · `publish` | [agent](/cli/commands/agent) |
| Templates | `template pack` · `publish` · `search` · `info` · `onboard` · `list` · `remove` | [template](/cli/commands/template) |
| Skills | `skill add` · `list` · `update` · `remove` · `search` · `info` · `publish` | [skill](/cli/commands/skill) |
| Orchestrations | `orchestration list` · `pull` · `push` · `status` · `add-agent` | [orchestration](/cli/commands/orchestration) |
| Tokens | `token create` · `list` · `revoke` · `clear` | [token](/cli/commands/token) |
Global flags
| Flag | Applies to | Description |
|---|---|---|
| `--yes`, `-y` | most commands | Skip confirmations / auto-overwrite. |
| `--harness <id>` | onboard, sync, agent, orchestration pull / add-agent (NOT push) | Force the harness (e.g. `claude-code`). |
| `--scope <s>` | onboard, sync, agent | Force install scope: `global` or `project`. |
| `--agent <id>` | link | Attach this folder to an existing agent non-interactively. |
| `--no-tracking` | link, agent create | Skip routing LLM traffic through Brainbase. |
| `--track` | agent create | Route LLM traffic through Brainbase (off without a TTY). |
| `--shell <sh|fish>` | agent env | Output format (auto-detected from `$SHELL`). |
| `--all` | template list | Include installs from other folders. |
| `--force` | agent pull, agent push | Override local changes. |
| `--run-entrypoint` | agent pull | Execute the agent entrypoint after pulling. |
| `--graph-only` | orchestration push | Update only the graph, not member agents. |
| `--no-push` | orchestration add-agent | Create / wire locally but skip the push. |
| `--web <url>` | login | Web app URL. |
| `--org <id>` / `--team <id>` | agent, orchestration | Scope to an org / team. |
| `--name` | agent create, skill publish, token create | Name / label (alias `-n` for `token create`). |
| `--tagline` | agent create | Agent tagline. |
| `--from <agent>` | orchestration add-agent | Source edge into the new agent (repeatable). |
| `--to <agent>` | orchestration add-agent | Edge out of the new agent (repeatable). |
| `--description <text>` | orchestration add-agent | Description for the new member agent. |
| `--schema <json>` | orchestration add-agent | Edge payload schema. |
| `--visibility <s>` | template publish, skill publish | `public`, `unlisted`, or `private`. |
| `--category <s>` | template search, skill search | Filter by category (ignored by `publish`). |
| `--target <id>` | template search | Filter search results by target. |
| `--page <n>` | template search, skill search | Page through search results. |
| `--as <slug>` | skill add | Install the skill under a different slug. |
| `--skill-version <v>` | skill publish | Version to publish (`MAJOR.MINOR.PATCH`). |
Environment variables
Hosts, the config dir, and PATs are all configurable via environment variables — see Environment variables.