syncra-studio/brigadier-ai

Brigadier runs your CLIs — Claude Code and Codex today, more soon — as one team on your Mac.
You talk to one thread: a plain Claude Code or Codex session. It does most jobs itself, and when
a job calls for it, starts other CLI sessions as workers in their own git worktrees, getting a
review from the other vendor before it merges their work.
Workers, cross-vendor review. When a job calls for it — parallel parts, a long build,
research, a second opinion — the thread starts a worker: a plain Claude Code or Codex session
of its own choosing, in its own worktree. A worker runs its own checks, gets a review from the
other vendor's CLI when the work is worth one (codex review, or Claude on Codex's work), and merges into the thread that
started it.
Computer use in the background (macOS). Workers can open and use the apps they build, and
any other app a task needs, without moving your cursor or bringing the app to the front: a
step that would interrupt you is refused. System Settings is read-only to them. The
helper builds on a vendored open-source driver:
helpers/computer-use/README.md.
Long sessions without compaction. The thread never compacts its context. Before it fills, a
fresh session takes over from a handoff note, every decision so far and the latest messages.
Free and open source (MIT). Brigadier runs the claude and codex CLIs you already have, under
your own logins. It holds no API keys and never reads your credentials.
## Install
macOS 14 or later, Apple silicon or Intel. Signed and notarized.
sh
brew install --cask syncra-studio/tap/brigadier
Or download Brigadier-0.1.0-alpha-universal.dmg from the
latest release and drag
Brigadier to Applications. It updates itself. More ways, and how to uninstall:
docs/user/install.md.
You also need at least one of Claude Code and
Codex; Brigadier's setup can install them. Both is
better: each reviews the other's work. To build from source (or for Windows and Linux), see
docs/DEVELOPMENT.md. Windows builds a per-user installer
(…-x64-setup.exe) there; Windows releases aren't published yet
(docs/user/install.md).
## Quick start
1. Open Brigadier. Its setup connects your agents: it finds claude and codex, and can
install them or sign them in for you.
2. Pick a project: one it suggests from your recent Claude Code and Codex work, or any git
repository (+ next to Projects). It can also clone one, or start git in a folder.
3. Press New session on the project and say what you want in plain words.
4. The session works on its own branch, in its own worktree: it plans and changes the code,
running your checks and getting the other vendor's review itself. Then it merges the work, and
a Revert button sits under the merge message.
Step by step: docs/user/first-task.md.
## Sessions
One session is one task: a chat with an agent, on its own branch and worktree. The sidebar lists
each project's sessions with what each is doing and why (Working · waiting for reset 14:30,
Needs you · question, Ready · PR open, Merged); the ones that need you come first. For a second task at the
same time, start another session: New session on the project, or ⌘Enter in the composer
to start it in the background. A session can also offer to start something outside its task as