BIRCH DOCUMENTATION
Run agents. Keep your checkout clean.
Birch is a desktop Git client built around two ideas — every piece of work, yours or an agent's, lives in its own git worktree, and coding agents (Claude Code, Codex, OpenCode) are first-class citizens with live status, an inbox, and a review-first flow. If you know GitHub Desktop or Fork, Birch is that — plus a safe place to run agents in parallel.
Start here
Section titled “Start here”Download Birch and get past the first-launch security warnings.
From an empty install to your first agent-authored pull request, end to end.
The one idea Birch is built on — and why your own checkout is never touched.
Two ways through Birch
Section titled “Two ways through Birch”Everything in these docs hangs off one of two spines. Follow the one that matches what you came for.
Launch parallel workspaces, triage their turns in the Inbox, ship the PRs.
A fast, honest Git client underneath — commit, history, branches, conflicts.
Run agents. Hand work to a coding agent and stay in control of what ships: a task lands in the Inbox, one click creates a workspace — a fresh worktree with the agent already running — you review everything it changed against the base branch, then open the pull request. Your own checkout is never involved.
Daily Git. Birch is also a complete Git client: stage and commit with word-level diffs, browse history as a graph or a list, manage branches, and resolve conflicts in a dedicated resolver window. None of it requires using AI at all.
Platforms & quick links
Section titled “Platforms & quick links”Windows 10/11 (x64) and macOS 11+ (Apple Silicon and Intel). Linux is not supported.
- birch CLI reference — scriptable worktree, PR, and review commands with
--jsonoutput - Provider matrix — GitHub, GitLab, Azure DevOps, Jira, Linear, YouTrack
- AI in Birch — what runs on your agent CLI vs. the Anthropic API
- Troubleshooting