// the find
unclebob/swarm-forge
A simple tool for coordinating several AI agents.
SwarmForge is a tmux-based orchestration layer that runs multiple AI coding agents (Claude, Codex, Copilot, Grok) in parallel git worktrees, coordinating handoffs through a file-based daemon. It ships three preset workflows — two-pack, four-pack, six-pack — scaled to task complexity. This is Uncle Bob's project, so TDD and CRAP metrics are baked into the role prompts.
One git worktree per agent is the right call — it sidesteps merge conflicts between concurrent agents without any clever locking. The handoff daemon design is clean: agents write structured files, the daemon owns all tmux socket access, and agents never send tmux commands directly. Babashka as the scripting runtime is a good choice — Clojure semantics without JVM startup cost. The layered constitution system (shared articles on main, local overrides per branch) lets workflows diverge without forking everything.
The 'main is documentary, runnable code lives on branches' design is genuinely awkward — it inverts the normal mental model and the getting-started flow (curl-pipe a tar.gz from a named branch) will trip up anyone who reflexively clones main. The terminal backend is macOS-first: AppleScript is the default, caffeinate for sleep inhibition, Windows Terminal support is described as 'launch-only' with no window tracking. The test directory has exactly two files for a system with a non-trivial handoff state machine — that's not enough coverage for the edge cases around daemon restarts and mid-handoff crashes. Installing this requires zsh, tmux, Babashka, and at least one agent backend with appropriate credentials; that's a real setup cost that the README undersells.