五分钟上手 FoldGitFoldGit in five minutes

1. Download the FoldGit v0.1.0 macOS installer.
2. Open the DMG and drag FoldGit into Applications.
3. Requires an Apple Silicon Mac on macOS 26 or later, with Git installed. If Git is missing, run xcode-select --install in Terminal.

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. Download the installer and signing certificate for your architecture. Most Intel and AMD PCs use x64; PCs with Snapdragon or other ARM processors use ARM64.
2. Open PowerShell as administrator in your download folder and run the matching command below to import the self-signed certificate.
3. Open the MSIX installer for the same architecture and follow the installation prompts.

x64: Download installer · Download certificate

ARM64: Download installer · Download certificate

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.

• Groups — choose New Group from the + menu, or select several repositories and right-click New Group with Selection. Groups never move folders on disk.
• Rarely used repositories — right-click Mark as Inactive to tuck one into the folded section at the bottom of its group.
• Rename — set a Repository Display Name from the context menu. Only the sidebar label changes.
• Find and sort — the search field filters by name; the sort button orders by name, recently opened, modified or added. You can also drag to reorder.

1. Select a repository and click Uncommitted Changes at the top of the commit list.
2. Read the diff file by file. The + beside each hunk stages just that hunk, − unstages it; or use Stage All at the bottom.
3. Write a Commit Message and press ⌘↩ or click Commit. Tick Amend to rewrite the latest commit.

Diff layout defaults to Automatic: side by side when the window is wide enough, unified when it is not. You can switch it at the bottom.

• Click any commit to see what it changed.
• ⌘F searches commits by author, email or message.
• The menu beside the search field switches between Current Branch and All Commits.
• The branch icon at the bottom of the list shows or hides the commit graph.

Everything lives in the toolbar:

• Select Branch — switch, merge into the current branch, rename or delete.
• Create New Branch and Show Tags — create branches, browse and manage tags.
• Compare Branches or Tags — pick two revisions and see everything between them.
• Fetch / Pull / Push — sync with the remote. Fetch only downloads; it never merges.
• Open in — open the repository in Terminal, your editor or Finder.

1. Right-click a repository and choose Enable Worktrees. (The global switch under Settings → Repository 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 under Uncommitted Changes to set your work aside, then view and restore it from Show Stashed Changes in the toolbar.

Press ⌘,. The ones you will likely touch:

• Language and appearance — eight languages; light, dark or automatic. Restart after changing the language.
• Automatic Fetch — a fetch interval per repository.
• Code Display — diff layout, font size, wrapping long lines.
• Open in — pin your editor or terminal so it comes first in the menu.