git-graph-tui

A Git Graph for your terminal: see every branch, tag and stash as a colored graph, and act on it with a right-click 🌳

Documentation · Install · Releases

git-graph-tui brings the Git Graph extension for VS Code to the terminal. It is one native binary, ggt, that works in any terminal, over SSH, in tmux, and in herdr panes.

Terminal git tools make you choose. Some draw a beautiful graph but are read-only. Others manage git well, but their graph is an afterthought. Git Graph for VS Code is loved because it does both: you see the whole repository at a glance and act on it right where you look. git-graph-tui does the same, without leaving the terminal.

• A clear graph. Colored lanes, branch, tag and stash badges, and uncommitted changes at the top. Commits that aren't part of HEAD are muted.
• Right-click anything. Checkout, merge, rebase, cherry-pick, revert, reset, push, pull, tag, create a pull request, and more.
• Mouse and keyboard. Click, double-click, right-click and scroll, or do everything from the keyboard.
• Source Control pane. Stage, unstage, discard and commit, with amend and sign-off, like in VS Code.
• Commit details. Changed files as a tree with +/- counts, a built-in diff viewer, or your own pager (delta) or difftool.
• Power tools. Interactive rebase, conflict banner with continue and abort, reflog recovery, worktrees, compare commits.
• Safe. Every destructive action asks first and says exactly what will happen.
• Fast and simple. Loads history in pages and never blocks the UI. Its only dependency is git.

Context menus	Commit details
Find	Repository menu

Prebuilt binaries for macOS, Linux and Windows are on every release.

# Homebrew (macOS, Linux)
brew install allient/tap/git-graph-tui

# Shell installer (macOS, Linux)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allient/git-graph-tui/releases/latest/download/git-graph-tui-installer.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -c "irm https://github.com/allient/git-graph-tui/releases/latest/download/git-graph-tui-installer.ps1 | iex"

The command is ggt. It needs git on your PATH. To build it yourself, see Build from source.

Run it inside a git repository, or give it a path:

cd <your git repository>
ggt

ggt ~/code/my-project

Usage: ggt [OPTIONS] [PATH]

Arguments:
  [PATH]  Path inside the repository to open [default: .]

Options:
      --icons <STYLE>  Toolbar icons: VS Code's icons from a Nerd Font, or plain Unicode [possible values: auto, unicode, nerd]
  -h, --help           Print help
  -V, --version        Print version

The bottom bar always shows the main keys. See the keys reference for everything else.

Settings live in ~/.config/git-graph-tui/config.toml, and the file is optional. Pane and column sizes are saved for you when you quit. See configuration for icons, the diff pager and issue links.

• Documentation site: guides with screenshots for the graph, context menus, commit details and Source Control.
• docs/usage.md: every key, mouse action and config option in one page.
• docs/features.md: the full feature checklist and roadmap.
• docs/architecture.md: goals, tech stack and how the code is organized.
• herdr integration: open git-graph-tui in a herdr tab.

Requires Rust (rustup installs the pinned toolchain automatically) and git.

git clone https://github.com/allient/git-graph-tui.git
cd git-graph-tui
cargo run -- ~/code/my-project       # run it
cargo install --path crates/app      # or put ggt on your PATH

Want to help? See CONTRIBUTING.md for tests, linting, the docs site and releasing.

MIT. git-graph-tui is inspired by Git Graph for VS Code but contains no code from it; the extension has its own license. All implementation is original.