Enum Command 

pub enum Command {
    Init {
        template: Option<InitTemplate>,
        from: Option<String>,
        force: bool,
        agent: Option<String>,
    },
    ExportTemplate {
        name: String,
    },
    ExportRun,
    Retro {
        events: Option<PathBuf>,
    },
    Start {
        attach: bool,
    },
    Stop,
    Attach,
    Status {
        json: bool,
    },
    Send {
        from: Option<String>,
        role: String,
        message: String,
    },
    Assign {
        engineer: String,
        task: String,
    },
    Validate {
        show_checks: bool,
    },
    Config {
        json: bool,
    },
    Board {
        command: Option<BoardCommand>,
    },
    Inbox {
        command: Option<InboxCommand>,
        member: Option<String>,
        limit: usize,
        all: bool,
    },
    Read {
        member: String,
        id: String,
    },
    Ack {
        member: String,
        id: String,
    },
    Merge {
        engineer: String,
    },
    Task {
        command: TaskCommand,
    },
    Review {
        task_id: u32,
        disposition: ReviewAction,
        feedback: Option<String>,
        reviewer: String,
    },
    Completions {
        shell: CompletionShell,
    },
    Nudge {
        command: NudgeCommand,
    },
    Pause,
    Resume,
    Grafana {
        command: GrafanaCommand,
    },
    Telegram,
    Load,
    Queue,
    Cost,
    Scale {
        command: ScaleCommand,
    },
    Doctor {
        fix: bool,
        yes: bool,
    },
    Metrics,
    Telemetry {
        command: TelemetryCommand,
    },
    Chat {
        agent_type: String,
        cmd: Option<String>,
        cwd: String,
        sdk_mode: bool,
    },
    Shim {
        id: String,
        agent_type: String,
        cmd: String,
        cwd: String,
        rows: u16,
        cols: u16,
        pty_log_path: Option<String>,
        sdk_mode: bool,
    },
    ConsolePane {
        project_root: String,
        member: String,
        events_log_path: String,
        pty_log_path: String,
    },
    Daemon {
        project_root: String,
        resume: bool,
    },
}

Variants

Init

Scaffold .batty/team_config/ with default team.yaml and prompt templates

Fields

template: Option<InitTemplate>

Template to use for scaffolding

from: Option<String>

Copy team config from $HOME/.batty/templates//

force: bool

Overwrite existing team config files

agent: Option<String>

Default agent backend for all roles (claude, codex, kiro)

ExportTemplate

Export the current team config as a reusable template

Fields

name: String

Template name

ExportRun

Export run state for debugging

Retro

Generate a run retrospective

Fields

events: Option<PathBuf>

Path to events.jsonl (default: .batty/team_config/events.jsonl)

Start

Start the team daemon and tmux session

Fields

attach: bool

Auto-attach to the tmux session after startup

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

Fields

json: bool

Emit machine-readable JSON output

Send

Send a message to an agent role (human → agent injection)

Fields

from: Option<String>

Explicit sender override (hidden; used by pane bridge and automation)

role: String

Target role name (e.g., “architect”, “manager-1”)

message: String

Message to inject

Assign

Assign a task to an engineer (used by manager agent)

Fields

engineer: String

Target engineer instance (e.g., “eng-1-1”)

task: String

Task description

Validate

Validate team config without launching

Fields

show_checks: bool

Show all individual checks with pass/fail status

Config

Show resolved team configuration

Fields

json: bool

Emit machine-readable JSON output

Board

Show the kanban board

Fields

command: Option<BoardCommand>

Inbox

List inbox messages for a team member, or purge delivered inbox messages

Fields

command: Option<InboxCommand>

member: Option<String>

Member name (e.g., “architect”, “manager-1”, “eng-1-1”)

limit: usize

Maximum number of recent messages to show

all: bool

Show all messages

Read

Read a specific message from a member’s inbox

Fields

member: String

Member name

id: String

Message REF, ID, or ID prefix from batty inbox output

Ack

Acknowledge (mark delivered) a message in a member’s inbox

Fields

member: String

Member name

id: String

Message REF, ID, or ID prefix from batty inbox output

Merge

Merge an engineer’s worktree branch into main

Fields

engineer: String

Engineer instance name (e.g., “eng-1-1”)

Task

Manage workflow task state and metadata

Fields

command: TaskCommand

Review

Record a structured review disposition for a task

Fields

task_id: u32

Task id

disposition: ReviewAction

Review disposition

feedback: Option<String>

Feedback text

reviewer: String

Reviewer name (default: human)

Completions

Generate shell completions

Fields

shell: CompletionShell

Shell to generate completion script for

Nudge

Per-intervention runtime toggles

Fields

command: NudgeCommand

Pause

Pause nudges and standups

Resume

Resume nudges and standups

Grafana

Manage Grafana monitoring (setup, status, open)

Fields

command: GrafanaCommand

Telegram

Set up Telegram bot for human communication

Load

Estimate team load and show recent load history

Queue

Show pending dispatch queue entries

Cost

Estimate current run cost from agent session files

Scale

Dynamically scale team topology (add/remove agents)

Fields

command: ScaleCommand

Doctor

Dump diagnostic state from Batty state files

Fields

fix: bool

Remove orphan branches and worktrees after confirmation

yes: bool

Skip the cleanup confirmation prompt

Metrics

Show consolidated telemetry dashboard (tasks, cycle time, rates, agents)

Telemetry

Query the telemetry database for agent and task metrics

Fields

command: TelemetryCommand

Chat

Interactive chat with an agent via the shim protocol

Fields

agent_type: String

Agent type: claude, codex, kiro, generic

cmd: Option<String>

Shell command to launch the agent CLI (auto-detected from agent type if omitted)

cwd: String

Working directory for the agent

sdk_mode: bool

Use SDK mode (NDJSON stdin/stdout) instead of PTY screen-scraping

Shim

Internal: run a shim process (spawned by batty chat or orchestrator)

Fields

id: String

Unique agent identifier

agent_type: String

Agent type: claude, codex, kiro, generic

cmd: String

Shell command to launch the agent CLI

cwd: String

Working directory for the agent

rows: u16

Terminal rows

cols: u16

Terminal columns

pty_log_path: Option<String>

Path to write raw PTY output for tmux display panes

sdk_mode: bool

Use SDK mode (NDJSON stdin/stdout) instead of PTY screen-scraping

ConsolePane

Internal: interactive shim pane bridge for tmux

Fields

project_root: String

Project root directory

member: String

Member/agent id

events_log_path: String

Path to the shim event log

pty_log_path: String

Path to the shim PTY log

Daemon

Internal: run the daemon loop (spawned by batty start)

Fields

project_root: String

Project root directory

resume: bool

Resume agent sessions from a previous run

Trait Implementations

impl Debug for Command

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for Command

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Command

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand