This release is a pre-release and may not be stable for production use.
Brigade keeps coding-agent work trackable across tools, repos, and sessions: tasks, receipts, shared memory, and synced tools.
Install · Docs · Compare · Quickstart
Published v0.27.0 is the stable install (brigade-cli==0.27.0). It adds per-repo parallel-safe work waves, cross-repo ready-work campaigns, Memory Operations, an optional fleet hub, care-managed memory jobs, cloud seats with receipts, vault projection, run lineage, code-graph views, bounded recall, declared budgets, and a machine-readable control crosswalk. Main is now the 0.28 beta line.
What it does
- Ready work and claim safety. Brigade lists unblocked tasks and uses atomic claims so two agents cannot take the same item.
- Declared run limits, optional fleet hub, and registered cloud activity. Brigade enforces declared wall-clock and worker-dispatch ceilings, records named retry and reroute decisions, can report runs, repo claims, and external harness sessions through an operator-owned fleet hub, and reconciles registered cloud work against provider and GitHub state.
- Verification receipts. A check run through Brigade writes the command, the real exit code, and the Git state. Not every Brigade command writes a receipt.
- Owner-mediated handoffs and bounded recall. Handoffs are linted and routed by the memory owner. Safe targeted notes may auto-file, while ambiguous or risky notes wait for review. Session-start recall is capped, and vault project, search, and propose are bounded.
- Explicit dry-run-first harness projection. MCP servers, tools, and skills are previewed before Brigade writes them into a harness.
Learning in Brigade is outcome-based skill scoring, promotion, and rollback from captured verification receipts. It is not autonomous reflective memory learning.
Install
Install with pipx install brigade-cli or uv tool install brigade-cli, then follow the install guide, QUICKSTART.md, or give first 10 minutes and docs/agents-guide.md to your coding agent.
Stable channel: published v0.27.0. Preview channel: brigade update --channel beta for 0.28.0.devYYYYMMDD wheels. Details: update channels.
How it compares
Brigade overlaps several categories. Most adjacent projects specialize in one layer. Brigade connects those layers around trackable coding-agent work. Where a neighbor is stronger, that cell says so. Dated sources and longer notes: docs/comparison.md (2026-08-27).
Comparison key: 
Work and orchestration
| Project | Ready work | Claim safety | Parallel and run control | Task-store boundary | Verification |
|---|---|---|---|---|---|
| Brigade | Stable ready set |
Fail-closed local CAS. 0.27: optional hub claims |
0.27: per-repo waves, campaign-composed waves, declared limits, named retry/reroute, fleet board |
Local JSON ledger. Optional hub for events/claims, not a task DB |
Command receipts |
| Beads | Built in |
Atomic claim |
Agent workflow + Dolt sync |
Dolt-backed distributed store |
Task history |
| Gas Town | Beads-backed |
Not documented |
Multi-agent runtime |
Beads ledger |
Operational state |
| nWave | Wave artifacts |
Not documented |
7 reviewed phases + TDD gates |
Git-tracked artifacts |
Phase validation |
| ActiveGraph | Reactive graph |
Application-defined |
Behaviors + runs |
Append-only event log |
Replay, fork, and diff |
Memory
| Project | Durable memory | Capture and recall | Care and operations | Learning | Provenance |
|---|---|---|---|---|---|
| Brigade | Shared files + cards |
Handoffs. 0.27: bounded recall |
Owner policy. 0.27: Memory Operations, vault project/search/propose |
Outcome score + promote + rollback |
Work receipts + sources |
| Mem0 / OpenMemory | User + agent + session |
Automatic + hybrid search |
History + metadata |
Extraction + retrieval |
Timestamps + entities |
| Letta | Agent state + blocks |
Agent-managed tools |
Editable state |
Persistent agent runtime |
Persistent agent state |
| agentmemory | Shared coding-agent memory |
Hooks + MCP + REST |
Lifecycle + decay |
Not documented |
Searchable memory |
| Hindsight | Facts + experiences + models |
Retain + recall |
Reflect + feedback |
Reflective memory learning |
Temporal + causal links |
| Built-in harness memory | Tool-specific |
Rules + auto memories |
Varies by harness |
Harness-specific |
Harness-specific |
| OpenClaw | Plain files + index |
Keyword + optional vector search |
File-owned memory |
Not documented |
Files + source paths |
Tools and configuration
| Project | MCP | Reviewed rules and skills | Projection behavior | Source of truth | Audit and rollback |
|---|---|---|---|---|---|
| Brigade | MCP + tools catalog |
Skills + adapters |
Dry-run-first, then apply |
Brigade catalog |
Preserve + gate + rollback |
| add-mcp | MCP servers |
Not documented |
Maps fields into native files |
Registry + native files |
Warnings for dropped fields |
| Rulesync | Supported |
Rules + skills + hooks |
Per-target generation |
Rulesync project |
Generated outputs |
| config-sync | Not documented |
Rules for 12 tools |
Generated rule files |
Single config |
Generated outputs |
| chezmoi | As files |
As files |
Templates + apply |
Git-backed source dir |
Diff + templates + merge |
| agentsync | Many agent targets |
Skills + hooks + commands |
Native/lossy/skipped report |
Canonical config |
Native/lossy/skipped report |
Evidence and operations
| Project | Receipts | Code impact | Agent activity | Cloud state | Learning / replay |
|---|---|---|---|---|---|
| Brigade | Command + Git + optional impact |
Stable impact. 0.27: code-graph views + blast radius |
0.27: center activity + fleet board + external harness sessions |
0.27: registered cloud status + approved Grok Bot scout feed |
Score + promote + rollback. 0.27: run child/diff/resume |
| ActiveGraph | Event trace |
Not documented |
Reactive behaviors |
Not documented |
Replay, fork, and diff |
| CocoIndex | Data lineage |
Not documented |
Not documented |
Not documented |
Incremental recompute |
| Graphiti | Episode provenance |
Not documented |
Not documented |
Not documented |
Temporal fact updates |
| Hindsight | Not documented |
Not documented |
Not documented |
Not documented |
Reflective memory learning |
| Neo4j Agent Memory | Reasoning + tool traces |
Not documented |
Not documented |
Not documented |
Similar-task retrieval |
"Not documented" means the capability was not found in the project's official README or documentation on the dated source pass. Brigade cells were re-checked on 2026-08-27. Beads and Gas Town stay on the 2026-08-26 pass. Other neighbor cells stay on the 2026-08-13 pass. An event trace, memory history, data lineage, and a command verification receipt answer different questions.
Scope
Brigade is a local file-first control plane for coding agents. Nothing runs until a command or an operator-owned scheduler starts it. Optional serve commands (brigade center serve, brigade runs serve, brigade fleet serve) stay in the foreground until you stop them. Scheduling stays external, except optional operator-owned, target-scoped care registrations (brigade care install). The work ledger is machine-local JSON and is not a distributed task database. An optional fleet hub aggregates run events and arbitrates repo claims. The fleet board can show external harness sessions. Local journals stay authoritative. An approved Grok Bot scout feed enqueues labeled GitHub issues only after --apply. Ordinary runs have no hard run-budget unless one is declared. When declared, only wall-clock and worker-dispatch ceilings are enforced today. Model, tool, token, and cost dimensions stay observed unless an adapter owns an enforcement boundary. Campaigns aggregate ready work across repos and compose parallel-safe waves at query time from each member's per-repo partition. Center and the fleet board are read-only. External activity observations are best-effort. Cloud registry commands track work that another provider runs. Safe targeted handoffs may auto-file under owner policy. Ambiguous or risky notes wait for review.
Brigade is not a hosted memory service, automatic release bot, or full autonomous fleet runtime. It does not push to GitHub, publish packages, or send chat messages unless the operator uses an explicit send action. Name collisions: this is brigade-cli from escoffier-labs/brigade, not the archived CNCF/Microsoft Kubernetes Brigade, Spinabot Brigade, or the 2017 Python package that became Nornir.
Docs
- First 10 minutes · Overview · Technical guide · Comparison
- Execution model · Work closeout · Outcome scoring
- Memory care · Memory operations · Code intelligence · MCP sync
- Agents guide · Agent-assisted setup · README coverage
- Runbooks · Fleet hub on a Proxmox LXC
- Security · Command inventory · Contributing · Roadmap
License
MIT. See LICENSE.
Project identity: GitHub escoffier-labs/brigade, website brigade.tools, PyPI brigade-cli, command brigade.
1 maintainer
Release files for brigade-cli 0.28.0.dev20260920
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| brigade_cli-0.28.0.dev20260920-py3-none-any.whl | Python 3 | none | any | Details |
Release files / brigade_cli-0.28.0.dev20260920-py3-none-any.whl
| Download URL | brigade_cli-0.28.0.dev20260920-py3-none-any.whl |
|---|---|
| Size | 3.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1df1d29fb3715542d45e6d7df8ff377030f9e47129f3cb4dd4148db98cf892e
|
|
BLAKE2b-256 checksum How to use checksums |
6d82225137353c08431abefe392d340baf2402d96627fb04c23d197194a48e02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 20, 2026.
Transparency log
