# SmallGit

> A free, native Git GUI for macOS and an open-source SmartGit alternative. Review diffs, stage changes and manage repositories with SwiftUI.

SmallGit, Small Potato. Created by VUBA.

[Website](https://smallgit.vuba.one/)

## Download and install

**[Download SmallGit from GitHub Releases](https://github.com/vubaone/SmallGit/releases/latest)**

Requires **macOS 14 or later** and **Git** installed on your Mac (`git --version`).
The current prebuilt app is for **Apple silicon (`arm64`)**. Intel and universal
downloads are not available yet.

1. Open the release's **Assets** and download `SmallGit-<version>-macos-arm64.zip`.
   The automatically generated "Source code" archives do not contain the app.
2. Unzip it and drag `SmallGit.app` into **Applications**.
3. Open SmallGit. Each release includes a `.sha256` checksum and a `.json` build
   manifest with the source commit, architecture and signing details.

The download is **signed with Developer ID and notarized by Apple**, with the
notarization ticket included in the app. The release pipeline verifies Gatekeeper
acceptance after extracting the final ZIP.
You can also [build from source](https://github.com/vubaone/SmallGit/blob/main/README.md#build--run).

## Get started

1. Choose **Open Repository…** (`⌘O`) and select an existing local Git repository.
2. Select a changed file to inspect its diff. Stage the changes you want to
   include with **Stage**; use **Unstage** to remove them from the index.
3. Choose **Commit**, review the staged changes, and write your commit message.
4. Use **Fetch**, **Pull** or **Push** to work with the configured remote.
   For GitHub HTTPS authentication, the sign-in dialog offers
   **Continue with GitHub CLI**. See [GitHub sign-in](https://github.com/vubaone/SmallGit/blob/main/docs/authentication.md).

## Why SmallGit

- **Native.** SwiftUI on macOS 14+. No Electron, no JVM.
- **Responsive updates.** Asynchronous Git commands, cached repository data and
  filesystem monitoring keep views up to date.
- **Real conflict tooling.** Four-pane built-in conflict resolver with
  theirs/ours/both and external tool hand-off (Beyond Compare, Kaleidoscope,
  FileMerge).
- **Focused diffs.** Compare staged changes (HEAD ↔ Index) or unstaged changes
  (Index ↔ Working tree), stage / unstage individual lines and ignore whitespace.
- **SmartGit import.** Imports repositories and groups from your existing
  SmartGit configuration.

## Status at a glance

| Area              | Status                                            |
|-------------------|---------------------------------------------------|
| Working tree, staging (file / hunk / line) | ✅ |
| Commit, push, pull, fetch                   | ✅ |
| Branches: create / switch / rename / delete | ✅ |
| Merge with built-in conflict resolver       | ✅ |
| Rebase, including interactive rebase        | ✅ |
| Stash (save / snapshot / pop / apply / drop / list / partial / keep-index) | ✅ |
| Journal / log with commit graph and reflog  | ✅ |
| Whole-history search (--grep / --author / -S / -G) | ✅ |
| Fixup workflow (commit --fixup + autosquash) | ✅ |
| One-click Undo (reflog-based)               | ✅ |
| Worktrees (add / remove / prune / open)     | ✅ |
| Clean Up (remote prune + gc, size report)   | ✅ |
| Blame, tags, remotes                        | ✅ |
| Window position restored per display        | ✅ |
| Terminal panel (⌃⌘T) in place of the diff   | ✅ |
| Cherry-pick UI                              | 🚧 |
| Submodules (states, log of a moved pointer) | ✅ |
| Bisect                                      | 🚧 |
| GPG signing, LFS, PR integration            | 📋 |

### Current limitations

Cherry-pick UI and the bisect wizard are still in progress. Interactive rebase
supports pick, squash, fixup, drop and reordering; reword and edit are not yet
supported. Dedicated GPG signing, Git LFS and pull-request interfaces are planned.

SmallGit is an independent project focused on common SmartGit workflows. It
does not yet cover every SmartGit feature.

## Moving from SmartGit

1. Choose **Sync from SmartGit** on the welcome screen or from the app menu.
   **Re-sync from SmartGit…** is also available in Settings.
2. Review the detected repositories, groups and missing paths, then choose
   **Import**. Existing repositories do not need to be cloned again.

The importer only reads SmartGit's configuration; it does not modify it.
Passwords are not imported. Configure Git credentials or use the GitHub CLI
sign-in when needed.

## License

[MIT](https://github.com/vubaone/SmallGit/blob/main/LICENSE) — © 2026 VUBA.

Dependency licenses are listed in [THIRD_PARTY_NOTICES.txt](https://github.com/vubaone/SmallGit/blob/main/THIRD_PARTY_NOTICES.txt)
and included in packaged app bundles. See [Security](https://github.com/vubaone/SmallGit/blob/main/SECURITY.md) to report a
vulnerability privately.
