braid sub-agents

Create, manage, and install sub-agent configurations from the CLI.

Subcommands

Subcommand	Description
`create`	Create a new sub-agent
`install`	Install a sub-agent to local coding tools
`list`	List saved sub-agents
`get`	Get a sub-agent by ID
`update`	Update a sub-agent
`remove`	Delete a sub-agent

Common options

Most subcommands accept:

Option	Description
`-s, --server <url>`	Override the braid server URL
`--api-key <token>`	Override the API key
`--json`	Output JSON

Subcommand options

Subcommand	Required options	Additional options
`list`	none	common options only
`get`	`--id <id>`	common options only
`create`	`--name <name>`, `--description <description>`, `--prompt <prompt>`	`--scope <scope>`, `--project-id <id>`, `--mode <mode>`, `--model <model>`, `--skills <list>`
`update`	`--id <id>`	`--name <name>`, `--description <description>`, `--prompt <prompt>`, `--mode <mode>`, `--model <model>`, `--skills <list>`
`remove`	`--id <id>`	`-y, --yes`
`install`	`--id <id>`	`-a, --agents <list>`, `-g, --global` plus common options

Examples

Create a sub-agent:

braid sub-agents create \
--name "code-reviewer" \
--description "Security-focused code reviewer" \
--prompt "You are a senior code reviewer..." \
--mode primary \
--skills "security-audit,api-error-handling"

Install a sub-agent to your local tools:

braid sub-agents install --id <agent-id> --agents claude-code,cursor

Install globally:

braid sub-agents install --id <agent-id> --global

List all sub-agents:

braid sub-agents list