CLI Reference¶
This reference is generated from Batty's clap command tree.
batty¶
Hierarchical agent team system for software development
Hierarchical agent team system for software development
Usage: batty [OPTIONS] <COMMAND>
Commands:
init Scaffold .batty/team_config/ with default team.yaml and prompt templates
start Start the team daemon and tmux session
stop Stop the team daemon and kill the tmux session
attach Attach to the running team tmux session
status Show all team members and their states
send Send a message to an agent role (human → agent injection)
assign Assign a task to an engineer (used by manager agent)
validate Validate team config without launching
config Show resolved team configuration
board Show the kanban board
inbox List inbox messages for a team member
read Read a specific message from a member's inbox
ack Acknowledge (mark delivered) a message in a member's inbox
merge Merge an engineer's worktree branch into main
completions Generate shell completions
telegram Set up Telegram bot for human communication
help Print this message or the help of the given subcommand(s)
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
-V, --version
Print version
batty ack¶
Acknowledge (mark delivered) a message in a member's inbox
Acknowledge (mark delivered) a message in a member's inbox
Usage: batty ack [OPTIONS] <MEMBER> <ID>
Arguments:
<MEMBER>
Member name
<ID>
Message ID (from `batty inbox` output)
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty assign¶
Assign a task to an engineer (used by manager agent)
Assign a task to an engineer (used by manager agent)
Usage: batty assign [OPTIONS] <ENGINEER> <TASK>
Arguments:
<ENGINEER>
Target engineer instance (e.g., "eng-1-1")
<TASK>
Task description
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty attach¶
Attach to the running team tmux session
Attach to the running team tmux session
Usage: batty attach [OPTIONS]
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty board¶
Show the kanban board
Show the kanban board
Usage: batty board [OPTIONS]
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty completions¶
Generate shell completions
Generate shell completions
Usage: batty completions [OPTIONS] <SHELL>
Arguments:
<SHELL>
Shell to generate completion script for
[possible values: bash, zsh, fish]
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty config¶
Show resolved team configuration
Show resolved team configuration
Usage: batty config [OPTIONS]
Options:
--json
Emit machine-readable JSON output
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty daemon¶
Internal: run the daemon loop (spawned by batty start)
Internal: run the daemon loop (spawned by `batty start`)
Usage: batty daemon [OPTIONS] --project-root <PROJECT_ROOT>
Options:
--project-root <PROJECT_ROOT>
Project root directory
--resume
Resume agent sessions from a previous run
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty inbox¶
List inbox messages for a team member
List inbox messages for a team member
Usage: batty inbox [OPTIONS] <MEMBER>
Arguments:
<MEMBER>
Member name (e.g., "architect", "manager-1", "eng-1-1")
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty init¶
Scaffold .batty/team_config/ with default team.yaml and prompt templates
Scaffold .batty/team_config/ with default team.yaml and prompt templates
Usage: batty init [OPTIONS]
Options:
--template <TEMPLATE>
Template to use for scaffolding
Possible values:
- solo: Single agent, no hierarchy (1 pane)
- pair: Architect + 1 engineer pair (2 panes)
- simple: 1 architect + 1 manager + 3 engineers (5 panes)
- squad: 1 architect + 1 manager + 5 engineers with layout (7 panes)
- large: Human + architect + 3 managers + 15 engineers with Telegram (19 panes)
- research: PI + 3 sub-leads + 6 researchers — research lab style (10 panes)
- software: Human + tech lead + 2 eng managers + 8 developers — full product team (11 panes)
- batty: Batty self-development: human + architect + manager + 4 Rust engineers (6 panes)
[default: simple]
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help (see a summary with '-h')
batty merge¶
Merge an engineer's worktree branch into main
Merge an engineer's worktree branch into main
Usage: batty merge [OPTIONS] <ENGINEER>
Arguments:
<ENGINEER>
Engineer instance name (e.g., "eng-1-1")
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty read¶
Read a specific message from a member's inbox
Read a specific message from a member's inbox
Usage: batty read [OPTIONS] <MEMBER> <ID>
Arguments:
<MEMBER>
Member name
<ID>
Message ID (or prefix) from `batty inbox` output
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty send¶
Send a message to an agent role (human → agent injection)
Send a message to an agent role (human → agent injection)
Usage: batty send [OPTIONS] <ROLE> <MESSAGE>
Arguments:
<ROLE>
Target role name (e.g., "architect", "manager-1")
<MESSAGE>
Message to inject
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty start¶
Start the team daemon and tmux session
Start the team daemon and tmux session
Usage: batty start [OPTIONS]
Options:
--attach
Auto-attach to the tmux session after startup
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty status¶
Show all team members and their states
Show all team members and their states
Usage: batty status [OPTIONS]
Options:
--json
Emit machine-readable JSON output
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty stop¶
Stop the team daemon and kill the tmux session
Stop the team daemon and kill the tmux session
Usage: batty stop [OPTIONS]
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty telegram¶
Set up Telegram bot for human communication
Set up Telegram bot for human communication
Usage: batty telegram [OPTIONS]
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help
batty validate¶
Validate team config without launching
Validate team config without launching
Usage: batty validate [OPTIONS]
Options:
-v, --verbose...
Verbosity level (-v, -vv, -vvv)
-h, --help
Print help