mtarcure/claude-vibe-squad

What is it?

Key features

• 01Routes tasks to specialists bound to Claude, Codex, Gemini, Kimi or Grok CLIs
• 02Runs each mutating task in an isolated git worktree with a declared write scope
• 03Requires cross-family review for security- and judgment-critical work
• 04Stores specialist briefs, modes and skills as editable Markdown files
• 05Keeps run memory in a private Markdown vault outside the repository

Use cases

• Running several AI coding agents in parallel on separate branches of one repository
• Adding a second model family as an independent reviewer before merging AI-written changes
• Customising agent roles and workflows by editing Markdown instead of code

Quick start

1. 1

   Create a private memory vault and export its path

   mkdir -p "$HOME/Obsidian-Chrono" && printf '%s\n' '{"vault_id":"my-private-vault","schema_version":1}' > "$HOME/Obsidian-Chrono/.chrono-vault" && export CHRONO_VAULT_ROOT="$HOME/Obsidian-Chrono"
2. 2

   Clone the repository and install the Python environment

   git clone https://github.com/mtarcure/claude-vibe-squad.git && cd claude-vibe-squad && uv sync
3. 3

   Install the local leak guard hook and run the health check

   bash docs/install/install-pre-commit-hook.sh && bin/squad doctor
4. 4

   Launch the tmux control room with Chrono

   bin/squad up

Things to know

• !macOS only for now.
• !Requires several authenticated native CLIs for Claude, Codex, Gemini (agy), Kimi and Grok.
• !Agents run code from your checkout with your permissions; write scopes are not a sandbox.
• !Some optional features such as chrono-dedup are not distributed and need separate setup.

Topics

FAQ

What is claude-vibe-squad?

Multi-model AI coding orchestrator where a coordinator routes Markdown-defined specialist tasks to Claude, Codex, Gemini, Kimi and Grok CLIs in isolated git worktrees. Vibe Squad is a macOS-first orchestration layer for AI coding work. You describe a goal to a coordinator called Chrono, which splits it into scoped task files, assigns each to one of 71 role-based specialists, and launches the matching native CLI for Claude, Codex, Gemini (via agy), Kimi, or Grok. Each mutating task runs in its own git worktree with a declared write scope, and results are integrated only after checks pass.

Is claude-vibe-squad free to use? What license does it have?

claude-vibe-squad is open source under the MIT license. Check the license terms before using it in commercial products.

Is claude-vibe-squad still maintained?

Actively maintained. The last commit to claude-vibe-squad was on Sep 21, 2026.

What can I use claude-vibe-squad for?

Running several AI coding agents in parallel on separate branches of one repository Adding a second model family as an independent reviewer before merging AI-written changes Customising agent roles and workflows by editing Markdown instead of code

How do I install claude-vibe-squad?

Create a private memory vault and export its path: mkdir -p "$HOME/Obsidian-Chrono" && printf '%s\n' '{"vault_id":"my-private-vault","schema_version":1}' > "$HOME/Obsidian-Chrono/.chrono-vault" && export CHRONO_VAULT_ROOT="$HOME/Obsidian-Chrono" Clone the repository and install the Python environment: git clone https://github.com/mtarcure/claude-vibe-squad.git && cd claude-vibe-squad && uv sync Install the local leak guard hook and run the health check: bash docs/install/install-pre-commit-hook.sh && bin/squad doctor Launch the tmux control room with Chrono: bin/squad up

Where can I get claude-vibe-squad?

The source code and installation instructions are on GitHub: https://github.com/mtarcure/claude-vibe-squad