docs / getting started

Getting started

VibeTree runs each AI coding agent in its own git worktree. This page takes you from install to your first agent in a few minutes.

Install

macOS

Download the dmg from the latest release (Intel and Apple Silicon), or install through the Homebrew tap:

$ brew install --cask --no-quarantine sahithvibudhi/tap/vibetree

Builds are not yet notarized by Apple. If macOS blocks the app, approve it once under System Settings, Privacy and Security, or use the brew command above which skips the quarantine flag.

Windows

Download the Setup exe from the latest release. No admin rights required.

Linux

Download the AppImage or deb from the latest release.

Open a project

Launch VibeTree and pick any git repository with Open Project Folder. Projects open as tabs in the titlebar, so you can keep several open at once.

Create a worktree

Press the + button in the Worktrees sidebar, or Cmd/Ctrl+Shift+K, and name a branch. VibeTree runs git worktree add and opens an isolated checkout with its own terminal. Create one worktree per task or per agent; they never touch each other's files.

Launch an agent

Type your agent command in the terminal, for example claude, codex, or aider. To make it one click, save it as the project's agent preset: open project settings and set the agent command, which is stored in .vibetree/config.json and shared with your team.

The sidebar shows each worktree's state while agents run: a green dot for a live session, a badge with the changed file count, and a ding when an agent asks a question or finishes.

Review and ship

Switch to the Changes view to see the diff beside the terminal. Click a file and send a note straight back to the agent as its next prompt. When the work is good, commit and push from the same terminal.