boring-swarm 0.1.1

Standalone multi-agent swarm orchestrator

boring-swarm

Self-contained multi-agent swarm orchestration. One binary (bsw), one declarative flow.toml, and default worker prompts.

Install

uv tool install boring-swarm

Or with pip/pipx:

pipx install boring-swarm

Quick Start

bsw init
bsw doctor
bsw spawn
bsw robot

• bsw doctor validates deps + local flow/prompt files.
• bsw robot runs hardened hybrid scheduling for autonomous operation.

Structure

boring-swarm/
├── cli/bsw/              # Go source — compiled into platform wheels via go-to-wheel
├── defaults/
│   ├── prompts/
│   │   ├── impl_worker.md
│   │   ├── impl_proofer.md
│   │   ├── impl_reviewer.md
│   │   ├── impl_committer.md
│   │   └── plan_reviewer.md
│   └── flow.toml         # Default state machine definition
└── deps.toml             # External dependency declarations

Dependencies

External — installed separately:

Dep	Role
br	Work item CRUD (beads)
bv	Verification / robot ops
ntm	Tmux session + pane management
agent-mail	Inter-agent messaging (MCP)

Prompt resolution

bsw init materializes local files:

1. .bsw/flow.toml
2. .bsw/prompts/*.md

After init, runtime reads only local .bsw/* files. Users can fully overwrite flow.toml.

Flow DSL

• Full DSL reference: docs/FLOW_DSL.md
• Default example: defaults/flow.toml

Build wheels locally

Requires Go 1.24+ and go-to-wheel:

pip install go-to-wheel
go-to-wheel cli/bsw --name boring-swarm --version 0.1.0 --entry-point bsw

Wheels are built automatically on GitHub release via CI.