Install on macOS

Build an Apple Silicon app with Xcode and open your first repository in GitTurtle.

Prepare your Mac

Use an Apple Silicon Mac, Python 3.11 or later, Git, Rust through rustup and full Xcode 26 or later. Open Xcode once to finish setup. In Xcode’s settings, select its Command Line Tools and install the Metal Toolchain component.

uname -m
python3 --version
xcodebuild -version
xcrun metal --version

The first command should print arm64. The packager builds for Apple Silicon only.

Clone the project

git clone https://github.com/FernandoX7/GitTurtle.git
cd GitTurtle
rustup show active-toolchain

Run these commands from your development folder. Inside the clone, rustup selects the project’s Rust 1.99.0 toolchain. Keep the checkout and its lockfile together.

Build and open the app

./scripts/package-macos.sh
open dist/GitTurtle.app

The packager compiles the release executable, adds the app icon and license files, then signs the bundle locally. This development app uses an ad-hoc signature and has no notarization. In Projects, open a local Git repository or linked worktree.

Check the build

codesign --verify --deep --strict dist/GitTurtle.app
dist/GitTurtle.app/Contents/MacOS/gitturtle --build-info

If Metal cannot be found, finish installing the Metal Toolchain in the selected Xcode and check xcrun metal --version again. Continue to your first repository, get help or choose another platform.