Gutter

A fast git client for macOS, Linux and Windows, inspired by GitKraken. Built with Flutter on top of your system git.

Disclaimer: This app was heavily vibe coded with Claude Opus 5.5. Mostly out of spite of GitKraken becoming ever so bloated and unstable.

Gutter needs git installed.

• Linux, Flatpak: install it from Gutter's Flatpak repository:

  flatpak install --user https://serjlee.github.io/gutter/gutter.flatpakref

Or download the latest build from the Releases page:

• macOS (Gutter-macos-<version>.zip, Apple Silicon and Intel): move Gutter.app to /Applications, then clear the quarantine flag (the app isn't notarized): xattr -dr com.apple.quarantine /Applications/Gutter.app
• Linux, tarball: extract gutter-linux-x64-<version>.tar.gz and run ./gutter (needs GTK 3).
• Windows (x64): run Gutter-windows-x64-<version>-setup.exe. It isn't signed: on SmartScreen's warning, click More info → Run anyway.

From then on the macOS app, the tarball and the Windows app update themselves: Gutter offers each new release, downloads it, checks it against the release's checksums and swaps it in when you restart or quit. The Flatpak updates from its repository: Gutter runs flatpak update for you, and your software center or flatpak update work too.

• Commit graph: lane-colored branches, merged local/remote ref labels, tags, with support for stashes, search, avatars, and more.
• Tabs, tabbed repositories with grouping support and search.
• Repository discovery: every repository under a folder is found in the background. Open, clone or init from the home tab.
• Diffs: unified, split or full file (images too), with optional syntax highlighting.
• Interactive rebase without a text editor, with keyboard shortcuts and actions on several commits at once. The editor docks under the graph, which shows the plan as you make it and stays browsable.
• Conflicts resolved in the app: current, incoming or both for each conflict, or a whole side per file, for merges, rebases, cherry-picks and stashes.
• Errors explained, with the full output one click away in each tab's Output panel, which logs every git command it ran.
• Light and dark themes, following the system's by default.
• UI zoom for high-DPI screens.

Besides your own fetch, pull and push, Gutter makes two kinds of requests:

• Update check: every 6 hours it asks GitHub for Gutter's releases, and offers the latest when there's a newer one, with the notes of every release since yours. It downloads the release (from GitHub) only when you choose to update.
• GitHub avatars (repositories on GitHub only): each author's picture is requested from GitHub's avatar server by commit email, as rows come into view.

Fetch, pull and push use your git setup (SSH agent, credential helper). Gutter never shows a password prompt.

You need Flutter (stable) and git; on Linux also clang cmake ninja-build pkg-config libgtk-3-dev; on Windows, Visual Studio with "Desktop development with C++".

flutter run -d macos          # or: -d linux, -d windows
flutter analyze && flutter test

xvfb-run flutter drive --profile -d linux \
  --driver test_driver/integration_test.dart \
  --target integration_test/app_test.dart         # real app, AOT-compiled
dart run tool/bench_layout.dart 200000            # graph layout benchmark
dart run tool/bench_repo.dart /path/to/big/repo   # history load timings
tool/make_demo_repo.sh /tmp/demo                  # branchy demo repository
tool/make_icons.sh                                # icons from assets/icon/source.png

lib/git/     git runner, parsers, Repository API, partial patches, rebase plans
lib/graph/   lane layout + row painter
lib/scan/    repository discovery
lib/app/     app state, settings, theme, zoom, avatars
lib/ui/      shell, tabs, graph view, sidebar, details, diff, dialogs

GPL-3.0-or-later. Copyright (C) 2026 the Gutter contributors. See LICENSE.