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.

Screenshot

Demo

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

Quick start

Desktop app

Download the latest dmg, exe, or AppImage from the Releases page, or run from source:

pnpm install
pnpm dev:desktop

Server + web (browser and phone)

pnpm install
pnpm dev:all        # server + web dev servers; scan the QR code with your phone

Single-process production deployment (one server serves the UI and the API):

pnpm build
pnpm start:server   # http://localhost:3002

Or with Docker:

npm run deploy

The web app is an installable PWA: open it on your phone, add it to your home screen, and check on your agents from anywhere on your network.

Features

Worktree hooks

Automate per-worktree setup and teardown by adding executable scripts to your repository, using the same trust model as git hooks:

mkdir -p .vibetree/hooks

cat > .vibetree/hooks/post-create <<'EOF'
#!/bin/sh
# Runs in the new worktree after it is created
cp "$VIBETREE_PROJECT_PATH/.env" .env 2>/dev/null || true
npm install
EOF

cat > .vibetree/hooks/pre-remove <<'EOF'
#!/bin/sh
# Runs in the worktree before it is removed; failure warns but never blocks
docker compose down 2>/dev/null || true
EOF

chmod +x .vibetree/hooks/post-create .vibetree/hooks/pre-remove

Hooks receive VIBETREE_HOOK, VIBETREE_PROJECT_PATH, VIBETREE_WORKTREE_PATH, and VIBETREE_BRANCH. Output is captured and surfaced in the UI; a 120 second timeout kills hung scripts.

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 0.0.0.0 by default so phones can reach it. Authentication is off by default; to require a login, set:

AUTH_REQUIRED=true
VIBETREE_USERNAME=you
VIBETREE_PASSWORD=a-strong-password

The server warns at startup when it is network-reachable without auth. See apps/server/.env.example for all options, including LAN development mode.

Architecture

A pnpm + Turborepo monorepo. Desktop and web share one backend: the same server core is embedded by the Electron app and run standalone for the web.

apps/
  desktop/       Electron app (embeds the server on loopback)
  web/           React PWA (talks to the server over WebSocket)
  server/        Standalone server CLI (QR pairing, static web serving)
packages/
  core/          Git and PTY session logic, shared types, WebSocket adapter
  server-core/   Express + WebSocket server, auth, REST API
  ui/            Shared terminal component
  auth/          Login page and auth context for the web app

See ARCHITECTURE.md for details, and DOCKER.md for cloud deployment.

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

bin/launch-with-project /path/to/project [--name "CustomName"] launches the desktop app with a project pre-opened.

Roadmap

• Disk-persisted session buffers that survive server restarts
• An "agent needs input" dashboard across all worktrees
• Password setup from the web UI (the auth seam is in place)
• Homebrew, winget, and npx distribution

License

MIT. See LICENSE.