Why FoldGit
More and more code is written by AI agents, and reviewing changes rarely needs an IDE anymore. Production code still deserves a human look: which files changed, which lines moved, whether anything went out of bounds.
FoldGit is a small, quiet window for exactly that. It keeps all your repositories at hand, shows changes clearly, and follows the look and feel of macOS. Existing Git clients rarely manage to be beautiful, simple and lightweight at once, and similar projects had drifted too far in interaction and internals to adjust from within, so FoldGit started fresh.
Features
- Fold repositories, not folders. Every repository stays in the sidebar. Import a folder and its repositories become a group, or create groups that gather repositories from anywhere. Groups never move anything on disk. Inactive repositories fold one level deeper.
- Worktrees, first-class. Linked worktrees are discovered automatically and appear under their repository with the branch name. Create, move, lock, remove and prune them, and use Finish Worktree to merge into a target branch and clean up. The sidebar shows each worktree's status, and merged ones can be cleaned up in one pass. Conflicts are resolved in native sheets.
- Review and commit. Commit graph for the current branch or all commits, unified and side-by-side diffs (switching automatically with the window width), hunk staging, amend, revert, commit message templates and snippets.
- Commit View and Directory View. Review changes by commit, or browse complete files with syntax highlighting and jump to them from any diff (macOS).
- Branches, tags and comparison. Switch, merge, rename and delete branches, manage tags, and compare any two branches or tags.
- Native menus and shortcuts. Open recent repositories, run repository and commit actions, navigate to HEAD, and control diff views from the menu bar. Find the shortcut reference under Help.
- Fast search. Filter history by author, email or message as you type. Search runs in the background, reuses its index, pages results and cancels stale queries. It works with CJK input methods.
- Sidebar that scales. Filter by folder, repository or custom display name. Sort by name, recently opened, modified or added, or keep a manual order.
- Everyday extras. Push and pull, stash, Auto Fetch (download only, never merge), Open in your editor or terminal, light and dark appearances, and eight interface languages.
- Native and small. Written in SwiftUI and AppKit, no Electron. The installer is just a few MB.
Install
Requires an Apple Silicon Mac running macOS 26 or later, and Git. If Git is missing, run xcode-select --install.
Homebrew
With Homebrew installed:
brew install --cask dufu1991/tap/foldgit
To update, run brew update followed by brew upgrade --cask dufu1991/tap/foldgit.
Download the DMG
- Download the latest
FoldGit-macOS-arm64.dmg from Releases.
- Open the DMG and drag FoldGit into Applications.
Open FoldGit for the first time
After installing, double-click FoldGit in Applications. If macOS says it can’t verify the app, follow these steps.
- Click Done in the warning.
- Open System Settings → Privacy & Security, scroll to Security, and click Open Anyway next to the FoldGit message.
- Confirm that you want to open FoldGit and authenticate if prompted.
For future updates, use Check for Updates in FoldGit. macOS may ask you to approve FoldGit again after replacing it from a DMG or through Homebrew.
If Open Anyway is unavailable or macOS reports that FoldGit is damaged, download it again from the official FoldGit release and retry. If you’ve verified the app’s source and integrity and it still won’t open, use this Terminal command to remove the download quarantine from this copy, then reopen FoldGit.
xattr -dr com.apple.quarantine /Applications/FoldGit.app
User guide
See the user guide on foldgit.com.
Windows
The repository also contains a Windows client built with C#, WinUI 3 and .NET 10 (Windows 11 24H2 or later, x64 and ARM64). It is only a minimal implementation, and the author has no Windows machine to polish it on. Contributions are very welcome: see the Windows guide.
Download the Windows x64 or ARM64 EXE from Releases, then open it to install. Required runtimes are included.
Support FoldGit
FoldGit is independently developed and maintained by dufu. If it makes reviewing code and managing repositories easier for you, a donation helps support ongoing development and maintenance. Thank you for your support!
You can also scan a QR code with WeChat or Alipay. Click an image to view it at full size.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
