GitRonimo is a native macOS Git client written in Rust with GPUI. It keeps Git as the source of truth. The default engine is gitoxide gix for repository discovery, status, history, stage/commit, and HTTPS fetch/clone. Your installed Git executable remains the fallback (Settings Use system Git) and still handles credential helpers, SSH, hooks, signing, filters, LFS, checkout, merge, rebase, stash, and push.
Product version 2.0.5 (About GitRonimo). The Cargo workspace version stays independent; bump the string users see in apps/desktop/src/views/about.rs (APP_VERSION) after each release.
The current release includes:
- Welcome / Repositories — open, add, create, and clone local repositories; grouped bookmark folders
- Working Copy — status and diffs, Modified/All Files toggle, multi-select (
Command-A, Shift-click), batch stage/unstage via checkboxes, partial line/hunk staging, commit/amend/sign-off; focusing Commit Subject eases the description and options open; the changes preview scrolls when hunks or lines overflow the pane - History — bounded commit log with graph, two-line rows (author + branch/tag pills, then short hash + subject), scope filter, Changeset/Tree detail, double-click to Commit Detail, commit context menu
- Stashes, Remotes, Pull Requests, Settings — two-pane list + detail layouts (some secondary views remain palette-only)
- Workflow — GitHub Flow / GitLab Flow / git-flow templates, auto-detect, Start / Finish / Sync topic branches (welcome + in-repo)
- Branches — context menu (pin/archive/rename/delete…); pinned branches persist and sit at the top of BRANCHES; unmerged delete offers a force-confirm dialog
- Network — fetch, pull, publish, and push in the background with cancellation; progress in the activity bar; Pull/Push dialogs for options
- Command palette / Message history — searchable scrollable palette (
Command-Shift-P); activity-bar history of statuses, errors, and confirmations. Modal popups fade in and out; context menus stay instant. - About GitRonimo — application menu GitRonimo → About GitRonimo (icon, version 2.0.5, “Made in Austin ✩ Texas”, aomega.co, Check for updates)
- App Settings — GitRonimo → Settings… (Command-comma) for in-app updates
- Git engine — default
gix; Settings Use system Git forces the installed executable - Git LFS — Fetch / Pull from the LFS view and palette
- Stash extras — file drag onto Working Copy, optional auto-stash, named snapshots
- In-app updates — GitRonimo → Settings… (Command-comma), on by default; Check for Updates… on the GitRonimo menu, About, App Settings, and palette. SHA-256 and Gatekeeper before replace. No check on launch
- AI commit messages — Settings opt-in; Suggest fills the composer from the staged diff and never commits
- Safety — typed Git invocation, force-with-lease confirmation, local crash reports, recovery from missing repos and stale index locks
GitHub personal-access-token connect/sign-out lives in Settings (not a Services tab).
Not in product: OAuth / enterprise GitHub, VoiceOver roles (GPUI limitation), localization, and a built-in editor. Merge and rebase are available from menus plus continue/abort on Working Copy.
See PLAN.md for the full implementation contract and CHANGELOG.md for release notes.
| Shortcut | Action |
|---|---|
| Command-O | Open repository |
| Command-R | Refresh working copy |
| Command-A | Select all visible files (Working Copy) |
| Command-Shift-C | Focus commit subject (expands composer) |
| Command-Shift-S | Save stash |
| Command-Shift-P | Command palette |
| Command-/ | Shortcut reference overlay |
| Command-[ / Command-] | Back / Forward |
| Command-Q | Quit GitRonimo |
| Command-H | Hide GitRonimo |
| Command-, | App Settings |
| Command-F | Focus toolbar search |
Working Copy selection and batch checkbox staging: docs/keyboard-shortcuts.md.
Download the notarized universal app from GitHub Releases (Apple Silicon and Intel in one zip). After the v2.0.5 tag that file is GitRonimo-v2.0.5.zip.
To build a local .app:
./bin/build
open target/release-arm/GitRonimo.app # Apple Silicon
# open target/release-intel/GitRonimo.app # IntelThe menu bar title is GitRonimo (binary / bundle name). Gatekeeper will warn on unsigned builds; use the documented signing handoff for a distributable release. An installed Git executable is required.
cargo fmt --all -- --check
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace --all-features
cargo deny check| Doc | Description |
|---|---|
| docs/README.md | Documentation index |
| PLAN-v2 | Post-1.0 gix, updater, LFS/stash, AI commits (A/E/D/G in tree) |
| PLAN-v3 | Post-2.0 findability, GitHub OAuth/enterprise, polish (not mixed with gix fallbacks) |
| v1 todo | Leftover work and doc hygiene toward 1.0 |
| Architecture | Crate layers and mutation flow |
| Keyboard shortcuts | Global and Working Copy shortcuts |
| Desktop shell | Activity bar, palette, confirms, pins, About, App Settings, overlay fade |
| UI plan | UI phases |
| UI improve | View patterns and remaining UI gaps |
| Work log | Implementation notes |
| Troubleshooting | Recovery and toolchain |
| Packaging | Apple Silicon / Intel bundles, signing |
| Contributing | Development rules |
| AGENTS.md | Agent/coding constraints |
GitRonimo is not affiliated with any other Git client or Git hosting provider. Branding, assets, and copy are original.
Licensed under either of Apache License, Version 2.0 or MIT license, at your option.