从仓库整理到代码提交From repositories to reviewed commits

Requires an Apple Silicon Mac on macOS 26 or later, with Git installed. If Git is missing, run xcode-select --install in Terminal.

Install with Homebrew

With Homebrew installed:

brew install --cask dufu1991/tap/foldgit

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

Download the DMG

1. Download the latest FoldGit macOS installer.
2. Open the DMG and drag FoldGit into Applications.

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

Requires Windows 11 24H2 or later and Git. The Windows client is currently a minimal implementation.

1. Choose your architecture. Most Intel and AMD PCs use x64; PCs with Snapdragon or other ARM processors use ARM64.
2. Download and open the EXE installer. Follow the prompts. Required runtimes are included and no certificate import is needed.
3. Open FoldGit from the Start menu. Uninstall it through Windows Settings.

Download for Windows x64 · Download for Windows ARM64

Click + at the top of the sidebar:

• Add Local Repository or Directory — pick one repository, or a folder that contains several. A folder becomes a group automatically.
• Clone Remote Repository — enter the URL and choose where to save it. The clone is added and selected when it finishes.

The File menu works too: Open Repository (⌘O), Clone Remote Repository (⇧⌘N), and Open Recent to jump back to a recently used repository.

• Groups — choose New Group from the + menu, or select several repositories and right-click New Group with Selection. Groups never move folders on disk.
• Inactive repositories — right-click Mark as Inactive to tuck one into the folded section at the bottom of its group. Click a group or Inactive heading to expand or collapse it; the count shows how many repositories it contains.
• Rename — set a Repository Display Name from the context menu. Only the sidebar label changes.
• Find and sort — Search Repositories filters by folder, repository or display name. The sort button orders by name, recently opened, modified or added. You can also drag to reorder.

Select a repository and click Uncommitted Changes at the top of the commit list, or press ⌘1. The detail pane separates Unstaged Changes from Staged Changes. Start with the affected files, then expand the code you want to review.

• List and Directory Tree — use Changed File Display at the bottom to switch between them. Directory Tree is the default, with folders expanded and file diffs collapsed. List shows file paths; Directory Tree groups changes by folder.
• Inspect a folder or file — click a folder row to show or hide its children, or a filename to expand or collapse its diff. Collapsing a folder preserves the expansion state of its file diffs.
• Bulk controls — Expand Directories and Collapse Directories control the folder structure; Expand Diffs and Collapse Diffs control code content independently. Expand Diffs does not open collapsed folders.
• Shortcuts and menus — ⌥→ expands diffs and ⌥← collapses them. The View menu offers the same actions; directory controls appear in Directory Tree mode.
• Open a file — the ↗ on a file row opens the file from the current working directory in its default application.

Automatic switches between unified and side-by-side layouts based on the space available to the diff pane. You can also choose Unified or Side by Side explicitly. The side-by-side view labels Before and After, marks deletions and additions in red and green, and highlights changes within a line. The bottom controls, View → Diff Layout and Settings → History and Diffs share the same selection.

For a narrow window or long code lines, choose Unified or enable Wrap Long Lines under Settings → History and Diffs.

Staged Changes determines what goes into the next commit. Select changes by directory, file or hunk, or handle everything at once.

• By directory — in Directory Tree mode, click + beside a folder to stage changes beneath it, including subfolders and untracked files. The − beside a staged folder unstages its changes while keeping local files and edits.
• By file — + beside a filename stages the whole file; − unstages it. Expand Untracked Files to stage new files individually.
• By hunk — expand a text diff and use + on the right of a hunk to stage just that block, or − to unstage it. A partly staged file can appear in both panes.
• All changes — Stage All (⇧⌘S) and Unstage All (⌥⇧⌘S) act on all unstaged or staged changes respectively.

When you stage or unstage a file, its name moves toward the other pane and highlights the destination, making the change easier to follow. The flight animation is skipped when Reduce Motion is enabled in macOS. With staged files present, drag the divider between the panes to adjust the staged pane’s height, or double-click it to restore the default height.

Review, then commit

1. Check Staged Changes and expand the files to confirm what belongs in this commit.
2. Write a Commit Message. The snippet buttons below insert common prefixes; manage your own entries under Settings → Commit Messages.
3. Press ⌘↩ or click Commit. Unstaged edits remain in the working tree.
4. To rewrite the latest commit, tick Amend or choose Commit → Amend Last Commit in the menu bar.

• Click any commit to see what it changed. Historical commits also support List and Directory Tree with independent folder and diff expansion, including the changed files of merge commits. The file display choice is shared with the working changes view.
• ⌘F searches commits by author, email or message.
• The menu beside the search field switches between Current Branch and All Commits, as does View → History Scope.
• The branch icon at the bottom of the list shows or hides the commit graph, as does View → Commit Graph.
• ⌘0 jumps to HEAD: it clears the search and scrolls to the checked-out commit, loading older history if needed.
• With a commit selected, ⇧⌘C copies its hash; the Commit menu can also check out or revert the selected commit.

Everything lives in the toolbar, and in the Repository and Branch menus of the menu bar:

• Branch (⌘B) — switch, merge into the current branch, rename or delete.
• Merge Branch — choose Branch → Merge Branch, pick a local or remote branch, and merge it into the current one.
• New Branch (⇧⌘B) and Tags — create branches, browse and manage tags; ⇧⌘T creates a tag.
• Compare — pick two revisions and see everything between them.
• Fetch / Pull / Push (⇧⌘F / L / P) — sync with the remote. Fetch only downloads; it never merges. ⌘R refreshes the repository.
• Open in — open the repository in Terminal, your editor or Finder. ⌃⌘T opens Terminal, ⌃⌘O shows it in Finder.

1. Right-click a repository and choose Enable Worktrees. (The global switch under Settings → Repositories is on by default.)
2. Right-click New Worktree and pick a new or existing branch. It appears folded beneath the repository.
3. When you are done, right-click Finish Worktree: choose the target branch, merge, then optionally remove the folder and delete the source branch.

On conflicts, compare both sides in the sheet, keep one, or resolve in an external editor and continue.

Click Stash All Changes (⇧⌘H) under Uncommitted Changes to set your work aside, then view and restore it from Stashes in the toolbar.

Press ⌘,. The ones you will likely touch:

• General — choose the interface language, launch at login, restore the previous repository and window, check for updates at launch, and choose whether closing the last window quits the app. Restart after changing the language.
• Check for Updates — launch checks are enabled by default and only notify you when a newer version is available. To check manually, choose FoldGit → Check for Updates. Download opens the GitHub release page so you can choose an installer. Homebrew users can continue using the upgrade command above.
• Appearance — choose Light, Dark or Automatic, and set Toolbar Display to Icons Only or Icons and Text.
• History and Diffs — configure the commit graph, diff layout, code font size and line wrapping. Default File Expansion starts at Collapsed; choose Expanded to open new diffs with their contents visible. Files you expand or collapse manually keep their state.
• Commit Messages — manage snippets for common prefixes or text.
• Repositories — enable worktree information and choose an automatic fetch interval per repository. Fetch downloads remote updates without merging them.
• External Applications — pin an editor or terminal to place it first in the Open in menu.
• Restore Defaults — under General, review the settings that will be reset before confirming.