> ## Documentation Index
> Fetch the complete documentation index at: https://2026commitplusinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```bash theme={null}
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:

  ```bash theme={null}
  xcode-select --install
  ```

## Build from the command line

```bash theme={null}
# 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

```bash theme={null}
open $(ls -dt ~/Library/Developer/Xcode/DerivedData/macgit-*/Build/Products/Debug/Commit+.app | head -n 1)
```

## Build with Xcode

```bash theme={null}
open macgit.xcodeproj
```

Then press `Cmd+R` to build and run.

## Run tests

```bash theme={null}
xcodebuild -project macgit.xcodeproj -scheme macgit -destination 'platform=macOS' test
```

For contributor setup details, see [Local Development](/docs/local-development).