A Flutter/macOS desktop Git client that manages repositories without a
working-tree clone. It drives git / glab / gh on a host — a remote
POSIX machine over SSH, or this Mac via Process.start — and renders status,
history, diffs, branches, and GitHub/GitLab forge data (PRs/MRs, pipelines,
live CI traces) in a native macOS UI.
macOS is the only target platform.
- Remote (SSH) and local backends behind one
CommandExecutorseam - Working-tree status (porcelain v2), diffs, commits, branches, stashes, conflicts
- Real-time refresh via remote
fswatch/inotifywaitor localDirectory.watch - GitHub and GitLab: pull/merge requests, issues, pipelines, live CI traces
- Saved connection profiles (Keychain secrets; unsigned builds fall back to a
0600dotfile)
- Build: macOS with Xcode (see docs/BUILD_MACOS.md)
- Remote host: POSIX shell,
git2.x,glab/ghas needed, optionalfswatchorinotifywait
flutter pub get
flutter analyze
flutter testAnalyze and unit tests run on any platform. The .app is built on a Mac via
./build_macos.sh (use --unsigned if no Apple signing
certificate is configured).
See docs/ARCHITECTURE_PLAN.md. Instructions for coding agents live in AGENTS.md.