Expand description
Team mode — hierarchical agent org chart with daemon-managed communication.
A YAML-defined team (architect ↔ manager ↔ N engineers) runs in a tmux session. The daemon monitors panes, routes messages between roles, and manages agent lifecycles.
Modules§
- artifact
- auto_
merge - Auto-merge policy engine with confidence scoring.
- board
- Board management — kanban.md rotation of done items to archive.
- board_
cmd - board_
health - Board health dashboard — task counts, age, blocked chains, throughput.
- capability
- Workflow capability resolution for topology-independent team behavior.
- checkpoint
- Progress checkpoint files for agent restart context.
- comms
- External communication channels for user roles.
- completion
- config
- Team configuration parsed from
.batty/team_config/team.yaml. - config_
diff - Diff two team configurations to produce a topology change set.
- cost
- daemon
- Core team daemon: poll loop, lifecycle coordination, and routing.
- delivery
- deps
- Dependency graph visualization for board tasks.
- doctor
- errors
- estimation
- Task time estimation from telemetry — median cycle time by tag set.
- events
- Structured JSONL event stream for external consumers.
- failure_
patterns - Rolling failure-signature detection over recent team events.
- git_cmd
- grafana
- Grafana monitoring: bundled dashboard template and CLI commands.
- harness
- hierarchy
- Instance naming and manager↔engineer partitioning.
- inbox
- Maildir-based inbox messaging system.
- layout
- tmux layout builder — creates zones and panes from team hierarchy.
- merge
- Merge orchestration extracted from the team daemon.
- message
- Team message types and command queue management.
- metrics
- metrics_
cmd batty metrics— consolidated telemetry dashboard.- nudge
- Dependency-aware nudge target selection.
- policy
- resolver
- Resolve board tasks into runnable workflow states.
- retrospective
- Pure event-log analysis and markdown report generation for retrospectives.
- retry
- Retry helpers for transient failures with configurable exponential backoff.
- review
- Review and merge transitions for Batty-managed workflow metadata.
- scale
- CLI-side scale command: mutates team.yaml to change instance counts or add/remove manager roles. The daemon detects the config change via hot-reload and reconciles the running topology.
- standup
- Standup status gathering and delivery helpers.
- status
- tact
- task_
cmd - task_
loop - Task-loop helpers extracted from the team daemon.
- telegram
- Native Telegram Bot API client for batty.
- telemetry_
db - SQLite-backed telemetry database for agent performance tracking.
- validation
- watcher
- Disk-based session monitoring — polls agent output via tmux capture-pane.
- workflow
- Workflow state model for Batty-managed tasks.
Structs§
- Assignment
Delivery Result - Init
Overrides - Overrides collected from the interactive init wizard.
- Team
Load Snapshot
Enums§
Constants§
- TEAM_
CONFIG_ DIR - Team config directory name inside
.batty/. - TEAM_
CONFIG_ FILE - Team config filename.
Functions§
- ack_
message - Acknowledge (mark delivered) a message in a member’s inbox by ID, prefix, or REF.
- assign_
task - Assign a task to an engineer via their Maildir inbox.
- attach_
team - Attach to a running team session.
- disable_
nudge - Create a nudge-disabled marker file, disabling the intervention at runtime.
- enable_
nudge - Remove a nudge-disabled marker file, re-enabling the intervention.
- export_
run - export_
template - Export the current team config as a reusable template.
- format_
assignment_ result - init_
from_ template - init_
team - Scaffold
.batty/team_config/with default team.yaml and prompt templates. - init_
team_ with_ overrides - Scaffold with optional interactive overrides applied to the template YAML.
- list_
available_ templates - list_
inbox - List inbox messages for a member.
- load_
assignment_ result - merge_
worktree - Merge an engineer’s worktree branch.
- nudge_
disabled_ marker_ path - Path to the nudge-disabled marker for a given intervention.
- nudge_
status - Print a table showing config, runtime, and effective state for each intervention.
- pause_
marker_ path - Path to the pause marker file. Presence pauses nudges and standups.
- pause_
team - Create the pause marker file, pausing nudges and standups.
- purge_
inbox - Purge delivered messages from one inbox or all inboxes.
- read_
message - Read a specific message from a member’s inbox by ID, ID prefix, or REF.
- resume_
team - Remove the pause marker file, resuming nudges and standups.
- run_
daemon - Run the daemon loop directly (called by the hidden
batty daemonsubcommand). - send_
message - Send a message to a role via their Maildir inbox.
- send_
message_ as - setup_
telegram - Run the interactive Telegram setup wizard.
- show_
load - Show an estimated team load value from live state, store it, and show recent load trends.
- start_
team - Start a team session: load config, resolve hierarchy, create tmux layout, spawn the daemon as a background process, and optionally attach.
- stop_
team - team_
config_ dir - Resolve the team config directory for a project root.
- team_
config_ path - Resolve the path to team.yaml.
- team_
events_ path - team_
status - Show team status.
- templates_
base_ dir - Returns
~/.batty/templates/. - validate_
team - Validate team config without launching.
- wait_
for_ assignment_ result