gulbanana/gg

---

gulbanana/gg.json

{
  "createdAt": "2024-02-08T06:58:08Z",
  "defaultBranch": "master",
  "description": "GG - Gui for JJ",
  "fullName": "gulbanana/gg",
  "homepage": "",
  "language": "Rust",
  "name": "gg",
  "pushedAt": "2026-03-12T14:07:28Z",
  "stargazersCount": 776,
  "topics": [
    "gui",
    "jj",
    "jujutsu",
    "vcs"
  ],
  "updatedAt": "2026-03-22T00:13:21Z",
  "url": "https://github.com/gulbanana/gg"
}

![icon]!(res/icons/24x24.png) GG - Gui for JJ

![screenshot]!(res/screenshot.png)

GG is a GUI for the version control system Jujutsu. It takes advantage of Jujutsu’s composable primitives to present an interactive view of your repository. The big idea: what if you were always in the middle of an interactive rebase, but this was actually a good thing?

Installation

GG is a desktop or web application with a keyboard & mouse interface, written in. It may be available in your favourite package manager, including…

# MacOS
brew install --cask gg
# Windows
winget install --id gulbanana.gg
# Any platform supported by [Tauri](https://tauri.app/)
cargo install --locked gg-cli

Binaries are published for several platforms on the releases page. Use the .dmg or .app.tar.gz on MacOS, and the .msi or .exe on Windows. We have .appimage, .deb and .rpm for some Linux platforms, but they aren’t as well-tested.

Setup

Run gg in a Jujutsu workspace, pass the workspace directory as an argument or launch it from a GUI and use the Repository->Open menu item. Tips:

• gg or gg gui will launch a native application, gg web will open a web browser.
• If you downloaded a release yourself, gg won’t be on your PATH - try adding /Applications/gg.app/Contents/MacOS/ or C:\Program Files\gg\.
• When using a POSIX shell on Windows, start gg can be used to run in the background.

Configuration

GG uses jj config; revset-aliases.immutable_heads() is particularly important, as it determines how much history you can edit. GG has some additional settings of its own, with defaults and documentation [here]!(src/config/gg.toml).

Features

GG doesn’t require JJ installed, but you’ll want it for tasks GG doesn’t cover. What it does cover:

• Use the left pane to query and browse the log. Click to select revisions, shift-click for multiple selection, double-click to edit (if mutable) or create a new child (if immutable).
• Use the right pane to inspect and edit revisions - set descriptions, issue commands, view their parents and changes.
• Drag revisions around to rebase them; move them into or out of a revision’s parents to add merges and move entire subtrees. Or just abandon them entirely.
• Drag files around to squash them into new revisions or throw away changes (restoring from parents).
• Drag bookmarks around to set or delete them.
• Right click on any of the above for more contextual actions.
• Push and fetch git changes using the bottom bar.
• View diffs or resolve conflicts in an external tool (if you have one configured).
• Undo anything with ⟲ in the bottom right corner.

More detail is available in [the changelog]!(CHANGELOG.md).

Future Features

There’s no roadmap as such, but items on [the to-do list]!(doc/TODO.md) may or may not be implemented in future.

Known Issues

GG is lightly maintained and may have bugs. In theory it can’t corrupt a repository thanks to the operation log, but it never hurts to make backups.

If your repo is “too large” some features will be disabled for performance. See [the default config]!(src/config/gg.toml) for details.