FoldGit

Every repository, folded into one window.
A native, lightweight Git client for macOS.

Website · User guide · 简体中文

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.

• 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. 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, and commit message templates.
• 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, per-repository 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 about 4 MB.

Requires an Apple Silicon Mac running macOS 26 or later, and Git. If Git is missing, run xcode-select --install.

With Homebrew installed:

brew install --cask dufu1991/tap/foldgit

To update, run brew update followed by brew upgrade --cask dufu1991/tap/foldgit.

1. Download the latest FoldGit-macOS-arm64.dmg from Releases.
2. Open the DMG and drag FoldGit into Applications.

Releases that are not notarized by Apple carry this command in their release notes. If macOS says FoldGit is damaged or cannot be verified, run it once, then open FoldGit again:

xattr -dr com.apple.quarantine /Applications/FoldGit.app

See the user guide on foldgit.com.

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.

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!

• Buy Me a Coffee
• PayPal

You can also scan a QR code with WeChat or Alipay. Click an image to view it at full size.

WeChat Pay	Alipay

Package.swift                 Shared Swift package entry
Package.resolved              Shared dependency lock
Shared/
  Sources/FoldGitCore/        Platform-independent Git and domain core
  Resources/Branding/         Shared icon sources, vector layers and images
  Resources/FileIcons/        Shared file type icons and matching rules
  Resources/Localization/     Source strings for eight languages
  Resources/Licenses/         Project and third-party licenses
  Fixtures/                   Cross-language behavior samples
  Testing/                    Reusable temporary-repository test helpers
  Tests/FoldGitCoreTests/     Shared core tests
Platforms/
  macOS/                      Native macOS app and all of its private files
    Sources/                  SwiftUI, AppKit, state and system services
    Resources/                Localizations and Apple asset catalogs
    Configuration/            App identity, signing and export settings
    Tests/                    macOS UI and integration tests
    FoldGit.xcodeproj/        Xcode project
    project.yml               XcodeGen spec
  Windows/                    WinUI 3 app, C# core, system adapters and installer packaging
Scripts/                      Resource generation, validation and packaging tools
website/                      Landing page and user guide (static)
.github/                      Build workflows for the core and each platform

The shared module does not depend on AppKit, SwiftUI or macOS preferences. The macOS app consumes it as a local Swift package instead of compiling shared sources into the app target.

Use Swift 6.2 or later with Git on PATH. From the repository root:

swift test
python3 Scripts/check-platform-boundaries.py
python3 Scripts/validate-windows.py   # Windows inputs that can be checked without the XAML compiler

CI validates the shared core, the Windows core and the macOS app separately.

Apple Silicon only, macOS 26 minimum. Verified with Xcode 27.1 and Swift 6.4. Open Platforms/macOS/FoldGit.xcodeproj.

Local Debug builds and tests use a fixed Apple Development certificate, so macOS keeps recognizing existing file access permissions across rebuilds. Copy Platforms/macOS/Configuration/LocalSigning.xcconfig.example to LocalSigning.xcconfig in the same folder and fill in your team ID (the OU field of the certificate subject). The file is git-ignored. You can set CODE_SIGN_IDENTITY to the certificate's SHA-1 fingerprint to pin a specific certificate. Keep the same bundle ID and app path while developing, and do not pass CODE_SIGNING_ALLOWED=NO; switching signing for the first time may ask for permission once. CI builds that never launch the app may still disable signing.

xcodebuild test -project Platforms/macOS/FoldGit.xcodeproj -scheme FoldGit \
  -configuration Debug -destination 'platform=macOS'

python3 Scripts/generate-resources.py --check
python3 Scripts/validate-localizations.py

Regenerate the Xcode project with XcodeGen 2.45 or later:

xcodegen generate --spec Platforms/macOS/project.yml

Shared brand assets live in Shared/Resources/Branding. macOS uses the layered icon directly; other platforms use the PNG and SVG layers next to it.

Build a local Apple Silicon (arm64) Release package:

Scripts/package-macos.sh

Output goes to dist/macos: FoldGit.app, a DMG and ZIP named macOS-arm64, and SHA-256 checksums. The local script uses ad hoc signing and does not notarize.

Set the version with python3 Scripts/version.py set <version> and push to main; the release workflow publishes the macOS DMG and Windows EXE installers. The Homebrew tap automatically checks for new releases every 6 hours and updates the cask using its own GITHUB_TOKEN, without a personal access token. GitHub scheduling may delay a run.

website/ is the static landing page and user guide published at foldgit.com, with no build step. See website/README.md for local preview and how screenshots are captured from demo repositories.

FoldGit is an open source project independently maintained by dufu, released under the MIT License. Copyright of the project's own code belongs to dufu.

Third-party code, Swift Subprocess, Swift System and Material Icon Theme keep their own copyright and license notices. The full text is in Shared/Resources/Licenses/LICENSE.txt, ships with the macOS app, and can be viewed under Open Source Licenses in Settings.