Installation

Build and run Commit+ from source on macOS.

You can download Commit+ from GitHub Releases or build it from source with Xcode.

Download a release

Use the latest release from GitHub:

open https://github.com/Tranthanh98/macgit/releases/latest

Direct distribution builds use Sparkle for app updates outside the Mac App Store.

Prerequisites

• macOS 26.2 or later

• Xcode 26.2 or later (includes the Swift toolchain)

• Git on your system (git --version). Install via Homebrew or the Xcode Command Line Tools:

  xcode-select --install
  

Build from the command line

# Clone
git clone https://github.com/Tranthanh98/macgit.git commit-plus
cd commit-plus

# Debug build
xcodebuild -project macgit.xcodeproj -scheme macgit -destination 'platform=macOS' build

# Release build
xcodebuild -project macgit.xcodeproj -scheme macgit -configuration Release -destination 'platform=macOS' build

Run the built app

open $(ls -dt ~/Library/Developer/Xcode/DerivedData/macgit-*/Build/Products/Debug/Commit+.app | head -n 1)

Build with Xcode

open macgit.xcodeproj

Then press Cmd+R to build and run.

Run tests

xcodebuild -project macgit.xcodeproj -scheme macgit -destination 'platform=macOS' test

For contributor setup details, see Local Development.