Command Reference

Command reference

Every command, grouped by area. Run brainbase help to print this same summary in your terminal.

bash

brainbase <command> [options]

Commands

Group	Commands	Reference
Auth	`login` · `logout` · `whoami`	auth
Agent	`agent create` · `pull` · `push` · `unpack` · `status` · `env` · `link` · `unlink` · `sync` · `run` · `publish`	agent
Templates	`template pack` · `publish` · `search` · `info` · `onboard` · `list` · `remove`	template
Skills	`skill add` · `list` · `update` · `remove` · `search` · `info` · `publish`	skill
Orchestrations	`orchestration create` · `list` · `pull` · `push` · `status` · `add-agent`	orchestration
Tokens	`token create` · `list` · `revoke` · `clear`	token

Global flags

Flag	Applies to	Description
`--yes`, `-y`	most commands	Skip confirmations / auto-overwrite.
`--harness <id>`	onboard, sync, agent create / pull / unpack, orchestration pull / add-agent	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	On pull, take cloud runtime/content changes; on push, keep local conflicts. It cannot change `machine_kind`.
`--run-entrypoint`	agent pull	Execute the agent entrypoint after pulling.
`--graph-only`	orchestration push	Push members, edges, edge settings, and schedule triggers without pushing member-agent content.
`--no-push`	orchestration add-agent	Create / wire locally but skip the push.
`--web <url>`	login	Web app URL.
`--org <id-or-slug>` / `--team <id>`	agent create, orchestration create / list	Scope to an organization and 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.