braid 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

Create options

Option	Description
`--name <name>`	Sub-agent name (required)
`--description <text>`	Sub-agent description (required)
`--prompt <text>`	System prompt (required)
`--scope <scope>`	`global` or `project`
`--project-id <id>`	Project ID for project-scoped sub-agents
`--mode <mode>`	`primary`, `subagent`, or `all`
`--model <model>`	LLM model override
`--skills <list>`	Comma-separated skill names to link

Examples

Create a sub-agent:

braid 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 agents install --id <agent-id> --agents claude-code,cursor

Install globally:

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

List all sub-agents:

braid agents list