┌─ [ 01 ] · a desktop git client for people who live in many repos
Two orthogonal ideas. Workspaces are durable groupings of repos — "these are Platform," "these are Payments" — the lens you use to fetch, status, and reset across a whole bucket at once. Worksets are tickets you can resume across repos, pinned to a feature branch — start, ship, archive, reset. Both run as plain git commands in the repos you already have, never inside .git.
over·git — a client that sits over your git repos, never inside .git. Stop using it anytime; your repos behave the same in any other tool.
api-gateway
~/payments/api-gateway
changes 3
committing as you <you@example.com> · system git config
@@ new file @@+ import { bucket } from "./bucket";++ export const loginLimiter = bucket({+ cap: 10,+ per: "60s",+ key: (req) => req.ip + ":" + req.body.username,+ }); @@ routes/login.ts @@+ import { loginLimiter } from "../middleware/rateLimit";- router.post("/api/login", login);+ router.post("/api/login", loginLimiter, login);
Two stacks of grouping. Workspaces above, worksets below.
[ 02 ] · inside the window
GitHub Desktop, Tower, and Fork are all one-repo-at-a-time. If your work spans services + shared libs + infra, you end up scripting your own "checkout feature/x everywhere" flow. Overgit fills that gap with two orthogonal ideas — workspaces for durable groupings, worksets for tickets — without ever writing inside .git.
A workspace is an identity-bearing bucket: "these repos are Platform," "these are Payments." It's the sidebar's collapsible section and the target for bulk actions across the whole group. Permanent. A repo can live in many workspaces — small shared libs are the common case.
A workset is a transient unit of in-flight work: "ship the auth migration across api-gateway, billing-svc, and ledger-core this week." Bound to a feature branch. Sits above the workspace list in the sidebar, waiting for you to pick up where you left off. Archive when shipped. Reset when done.
Overgit never writes inside .git. No manifest, no .overgit folder, no synthetic root, no special config. Workspaces and worksets live in overgit's settings file, not in your repos. Stop using overgit any time and your repos behave the same in any other tool.
Fetch every repo in a workspace. Status every repo. Reset every repo to its default branch — fan-out fetch → switch → hard-reset to origin/<default> across the whole group. Workspace-wide PR list via gh pr list --json merged into one view.
Pick the repos the ticket touches. Sync each to its default → pull → create the feature branch — all in one workflow. Per-repo outcomes if any of them fail. Stop scripting for d in */; do git checkout ….
Shipped the ticket? Archive the workset. It vanishes from the active sidebar into a collapsed "Archived" section. The repos on disk are unchanged — overgit just stops surfacing the grouping. Reactivate any time. Three weeks later, when oncall asks "how did we ship that?", it's right there.
One action fans out fetch → switch back to origin/<default> → hard-reset → delete the workset's bound branch across every member. Cleans up the whole feature in one shot. Same surface as workspace reset, scoped to just the repos the workset touched.
Both reset flows detect repos with commits not on origin/<default> and stop before the hard-reset would erase them. You get a [force reset (lose N)] / [skip] choice per repo, with the commit count visible. Never a silent disaster.
Type a message once, commit every dirty member, push every branch — per-repo outcomes if any of them fail. Same surface for fetch-all and "open PRs everywhere" via gh, scoped to the workset.
⌘B opens a searchable popover. Local + remote branches grouped, ↑↓/Enter, inline create-branch with optional sync-and-pull, per-branch cherry-pick with commit-list multi-select.
⌘K opens a context-aware palette: switch / create branches, jump to repos, workspaces, and worksets, search files, run repo actions (stage all, fetch, pull, push, AI review).
Detects claude, codex, and gemini. Pipes diffs into the chosen CLI in non-interactive mode. Suggest drafts a conventional-commit message from the staged diff and drops it into the commit input.
Changes / History / Files / Graph / Stash. Multi-select with checkboxes, bulk action bar (Stage / Stash / Discard). File editor sandboxed to registered repos with hljs syntax highlighting. Per-lane colored branch graph with ref labels.
⌘K palette · ⌘B branches · ⌘N new branch · ⌘1–4 tabs · ⌘R refresh · ⌘\ sidebar · ⌘, settings. Whatever auth your claude, codex, gemini, and gh already have is the auth Overgit uses. Nothing leaves your machine via Overgit.
[ 03 ] · what a workspace looks like
A workspace is a durable bucket of repos you treat as one. Aggregate health at a glance — who's dirty, who's ahead, who's behind — then fetch all, status all, or reset all in a single action. Click any row to drop straight into that repo.
4 repos in this workspace. Aggregate health below; click any row to open the repo.
1 dirty · 0 ahead · 0 behind
| repo | branch | dirty | ahead | behind |
|---|---|---|---|---|
| api-gateway~/payments/api-gateway | main | 2 | · | · |
| billing-svc~/payments/billing-svc | main | · | · | · |
| ledger-core~/payments/ledger-core | main | · | · | · |
| infra~/payments/infra | main | · | · | · |
one bucket · every repo · one action
[ 04 ] · the workset lifecycle
A workset is a ticket pinned to a feature branch and the repos that branch touches. Create it once — overgit branches across every member in one move. Commit and push together. Open every PR with gh. When the work ships, one action fetches, switches back to origin/<default>, hard-resets every member, and deletes the bound branch — with per-repo safety checks for unmerged commits. The repos never know they're related. Overgit knows.
feature/rate-limit across them.
status · one branch is the goal — sync the stragglers
one branch is the goal · resume the stragglers · then ship together
origin/main · deleted feature/rate-limit
origin/main · deleted feature/rate-limit
feature/rate-limit
origin/main · [force reset (lose 2)] · [skip]
Smart safety: any repo with commits not on origin/<default> stops and asks. The other repos still complete. You get per-repo outcomes, never a silent disaster.
[ 05 ] · why overgit exists
Overgit optimizes for the day your work spans four repos at once — when juggling them by hand is the thing slowing you down. Workspaces and worksets are UI groupings, not files on disk: every action is a plain git command run in the repo's own directory, so you keep moving without inventing a meta-format that something else has to understand. If you uninstall overgit tomorrow, your repos forget it ever existed.
It's built for the realistic case — your work spans services and shared libs and infra, your teammates use whatever client they like, and the only thing the repos agree on is git. Overgit sits over the top, coordinates, and stays out of the way.
Sibling project of overcli. Written & maintained by Lionel Farr and Owen Farr. Open-source — contributors, issues, and PRs welcome.
[ 06 ] · grab a build
Overgit is in beta. Builds are unsigned — no Apple Developer ID, no SmartScreen badge. Right-click is the trust ceremony. If that bothers you, the source is right there; build it yourself.
| ⌘ macOS arm64 + x64 | .dmg · .zip | ~ 120 MB | [download] |
| ⊞ Windows x64 + arm64 | NSIS installer | ~ 110 MB | [download] |
| 🐧 Linux x64 + arm64 | .AppImage · .deb | ~ 130 MB | [download] |