Native macOS Git client inspired by the GitHub Desktop workflow.
GimMac is a native macOS Git client focused on local Git workflows.
The MVP does not include GitHub platform-specific features. The app is inspired by GitHub Desktop interaction patterns, but aims for a native, AppKit-first implementation with fast local Git operations.
Target: roughly 60–70% functional parity with GitHub Desktop for core local workflows.
- Native macOS Git client.
- AppKit-first interface.
- Fast local Git operations.
- GitHub Desktop-like workflow.
- Safe Git operations by default.
- GPG and SSH commit signing through existing Git configuration.
- Useful advanced actions such as squash, force-with-lease, branch switching, and diff review.
- macOS 14.0+
- Swift
- AppKit-first UI
- System/Homebrew Git binary
PLAN.md— scope, phases, architecture, risks.DESIGN.md— UI, state models, diff model, UX and security rules.AGENTS.md— contributor and AI-agent rules.
Suggested folders:
docs/ contributor-facing technical docs
wiki/ user-facing notes and troubleshooting
This project uses XcodeGen.
Prerequisites:
Commands:
xcodegen generate
xcodebuild -project GimMac.xcodeproj -scheme GimMac -destination 'platform=macOS' clean buildStrict gate:
brew install swiftlint
./scripts/strict-ci.shThis project is maintained as a personal project.
Pull requests, patches, and external commits are not accepted unless explicitly requested by the maintainer.
You are free to fork the project under the license terms.
Icon source: 3D Cartoon Style Hook with Orange Ring by Munawar Hussain on Vecteezy.
This project uses AI assistance during design and implementation.
This project is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.
See LICENSE.