VibeTree
Run every AI coding agent in its own git worktree, in parallel.
Works with Claude Code, OpenAI Codex CLI, Gemini CLI, Aider, opencode, and any other terminal program.
VibeTree is mission control for parallel AI coding agents. Every task gets its own git worktree: an isolated checkout with its own branch and a persistent terminal. Run one agent per worktree, watch them all at once, review each branch's diff, and throw away failed experiments with one click. Use it as a desktop app, or run the server and drive your agents from any browser, including your phone.
Why worktrees
- Parallel agents do not stomp on each other: each works in its own checkout on its own branch
- Every conversation maps to one reviewable diff; review and merge per branch
- Failed experiment? Delete the worktree and its branch is gone with it
Install
macOS
brew install --cask --no-quarantine sahithvibudhi/tap/vibetree
Or download the dmg from the latest release (Intel and Apple Silicon). Builds are not yet notarized; approve the app once under System Settings, Privacy and Security, or use the brew command above.
Windows and Linux
Download the Setup exe, AppImage, or deb from the latest release.
From source
pnpm install
pnpm dev:desktop # desktop app
pnpm dev:all # server + web; scan the QR code with your phone
Features
| Feature | Description |
|---|---|
| Parallel worktrees | One isolated checkout, branch, and terminal per task |
| Any agent CLI | It is a real terminal: claude, codex, gemini, aider, or plain shells |
| Persistent sessions | Terminals keep running and scrollback survives reloads and reconnects |
| Fleet status | See which agents are working, waiting, or done; a ding when one needs you |
| Changes view | Review the diff beside the terminal and send a note back as the agent's next prompt |
| Browser preview | Dev server URLs are detected and opened next to the terminal |
| Lifecycle hooks | Run your own scripts when worktrees are created or removed |
| Phone access | Installable web app with QR pairing; check the fleet from anywhere on your network |
Worktree hooks
Executable scripts in your repository, using the same trust model as git hooks:
mkdir -p .vibetree/hooks
printf '#!/bin/sh\nnpm install\n' > .vibetree/hooks/post-create
chmod +x .vibetree/hooks/post-create
post-create runs in each new worktree; pre-remove runs before deletion and can never block it. See the hooks docs for environment variables and examples.
Security
- The desktop app embeds its server on 127.0.0.1 with a per-launch token; nothing is exposed to the network.
- The standalone server binds the network so phones can reach it, and warns at startup when reachable without auth. Enable login with
AUTH_REQUIRED=true,VIBETREE_USERNAME, andVIBETREE_PASSWORD. All options are in the configuration docs.
Development
pnpm install
pnpm dev:desktop # desktop app
pnpm dev:all # server + web
pnpm test:run # unit tests
pnpm --filter @vibetree/desktop test:e2e # desktop e2e (Playwright)
pnpm --filter @vibetree/web test:e2e # web e2e (Playwright)
pnpm typecheck && pnpm lint
Repo layout and design decisions live in ARCHITECTURE.md.
License
MIT. See LICENSE.