Skip to content
Download

DOCS / GETTING STARTED

Coming from other Git clients

If you already live in another Git client, this page maps its vocabulary onto Birch’s and tells you where your daily tools moved. The one real mental shift is the worktree-first model — everything else is familiar Git-client furniture.

Coming fromYou knowIn Birch
GitHub Desktop / Forkone checkout per repository, switched between branchesthe same checkout, registered as-is in the sidebar — extra work happens in separate worktrees, so you stop branch-switching under uncommitted changes
GitButlervirtual branches: several lines of work multiplexed in one working directoryworktrees: several lines of work in several real working directories, one branch each — plain git underneath
Conductoragent workspaces with copied-in local filesagent workspaces: the same idea — an isolated worktree with an agent terminal; Birch reads the same .worktreeinclude file

Birch registers your clone where it already is and never rewrites how you clone or where your repositories live. New work — yours or an agent’s — happens in worktrees under Birch’s own data folder. Repositories are only ever added explicitly; there is no background folder scanning.

ToolWhere in Birch
Stage / commit / discardthe Git view’s Changes tab → Commit changes
History and commit graphthe History tab → History
Branches, mergeBranches — branch creation (⌘⇧N / Ctrl+Shift+N) is live; the merge, rebase, rename, and delete dialogs currently are not (see the caution below)
Stash — apply / pop / dropthe Stash tab → Stash
Stash — createStash
Blame and file historyright-click a file on the Changes tab → Power tools
Interactive rebaseInteractive rebase
Tags, reflog, bisectPower tools
  • The Inbox — assigned issues, PR activity, and waiting agents in one triage list.
  • Agent workspaces — run Claude Code, Codex, or OpenCode in isolated worktrees with live status.
  • AI code review — automatic review of new PRs. How the AI pieces fit together: AI in Birch.
  • Linux support — Windows and macOS only.
  • External diff/merge tool integration — the Settings controls exist but are marked “coming soon”.
  • Repository auto-discovery — Birch never scans your disk; you add each repository yourself.

The FAQ explains the reasoning behind these choices.