claude-vibe-squad
Multi-model AI orchestration where behaviour is Markdown, not code. One coordinator routes scoped task packets to 71 role-based specialists across 5 model famil
What is claude-vibe-squad?
Multi-model AI orchestration where behaviour is Markdown, not code. One coordinator routes scoped task packets to 71 role-based specialists across 5 model families (Codex / Claude / Gemini / Grok / Kimi) — each working in an isolated git worktree, each reviewed by a rival family before it lands. One tmux session, no server.
Overview of claude-vibe-squad
What it is
Vibe Squad is a multi-model AI orchestration tool. One coordinator, named Chrono, routes scoped task packets to 71 role-based specialists across five model families: Codex, Claude, Gemini, Grok, and Kimi. Each specialist works in an isolated git worktree, and work that triggers review is checked by a model from a different family. The system runs in a single tmux session with no server. The instruction layer is written entirely in Markdown, which users can read and edit. Code handles only launching, worktree isolation, identity checks, atomic publication, admission control, and Git-integration boundaries.
Key features
- One coordinator (Chrono) turns a goal into a plan, selects the specialist and model for each part, runs workers in isolated git worktrees, and calls for independent review when risk warrants it.
- 71 specialists, each tied to the model family that suits its work.
- Each task runs in its own git worktree with a written list of files it may change; nothing merges until checks pass.
- A different model family reviews work that triggers review.
- Memory is written down and read back between runs, so learned lessons are reused.
- Three engagement states: modeless (default for ordinary work), Project (software, research, content, operations, learning), and Bounty (authorized offensive-security work with scope checks and reproduction by a different model family).
Use cases
- Build a polished landing page, test it in the browser, and show the result.
- Research a product idea, compare competitors, and turn it into a cited brief.
- Audit an authorized smart-contract target, keep every test in scope, and package only reproduced findings.
Getting started
macOS is required. Dependencies: tmux, fswatch, jq, curl, Python 3.13, uv, and authenticated native CLIs for Claude, Codex, Gemini (agy), and Grok. Create a private vault once: bash mkdir -p $HOME/Obsidian-Chrono printf '%s' 'vault_id:my-private-vault,schema_version:1' > $HOME/Obsidian-Chrono/.chrono-vault export CHRONO_VAULT_ROOT=$HOME/Obsidian-Chrono Then clone and launch: bash git clone https://github.com/mtarcure/claude-vibe-squad.git cd claude-vibe-squad uv sync bash docs/install/install-pre-commit-hook.sh bin/squad doctor bin/squad up bin/squad up opens a tmux control room with Chrono and a status window. Detach with Ctrl-b d, return with bin/squad attach.
License and pricing
The project is open source under the MIT license.
Based on the project's public README and repository metadata.