A reactive terminal UI for Git and GitHub where every panel talks to every other panel.

Files, Git, GitHub, and preview — all in one terminal, all aware of each other. Pick a branch and the file tree, commits, and preview update. Pick a file and commits filter to its history. Pick a PR and three panels reconfigure at once. No switching tools, no refreshing.

• Context-Aware — Panels react to your selections. Select a branch, file, worktree, remote, stash, or PR and every other panel updates to match.
• Commit-Files Mode — Enter on a commit shows only that commit's changed files in the tree. Escape restores.
• PR Triple-Sync — Select a PR and file tree, commits, and preview all update simultaneously.
• Git Filter — g cycles through three modes: all files → git-changed → branch diff. Preview switches to diff mode automatically.

• File Explorer — Navigate your project with git status markers, Nerd Font icons, create/rename/delete
• Fuzzy Finder — / for instant file search
• Syntax Highlighting — 100+ languages via Chroma
• Preview — Adapts to show file content, issue/PR bodies, workflow details, or diffs depending on selection. Press f to toggle between file-on-disk and contextual diff view. Click and drag to select text, y to copy.
• Inline Editor — Press e in the preview panel to edit files directly. Ctrl+S saves, Escape discards.

• Status & Staging — Stage, unstage, discard with single keystrokes. Partial staging for individual hunks and lines.
• Branches, Worktrees, Stash, Tags, Remotes, Reflog — Each as a dedicated tab with full CRUD operations.
• Diff — Inline and side-by-side modes with hunk navigation.
• Log — Commit graph with ASCII visualization.
• Merge, Rebase, Blame, Bisect, Undo/Redo — Complete git workflow without leaving the terminal.

• Issues, Pull Requests, Actions, Workflows, Releases — Each as a tab with filters and preview integration.
• Merge PRs — Merge pull requests with merge commit, squash, or rebase strategies and optional branch cleanup.
• Workflow Dispatch — Trigger CI/CD workflows with parameters from the TUI.

• Built-in chat powered by GitHub Copilot — read/write files, run git commands, search code, interact with issues and PRs.
• AI-powered commit messages, conflict resolution, code review, and PR descriptions.
• Collapsed, expanded, and full-screen overlay modes.

• Themes — Default, Catppuccin, Tokyo Night, Gruvbox, plus custom TOML themes.
• Session Persistence — Saves and restores layout on restart.
• Self-Update — grut update upgrades in-place.

See the Roadmap for what's coming next.

Screenshots

AI Chat

Git Info

Git Diff

Git Branches

Git Log

Fuzzy Finder

File Explorer & Preview

Themes

Default

Catppuccin

Tokyo Night

Gruvbox

curl -fsSL https://raw.githubusercontent.com/jongio/grut/main/install.sh | sh

To install a specific version:

curl -fsSL https://raw.githubusercontent.com/jongio/grut/main/install.sh | sh -s -- v0.1.0

irm https://raw.githubusercontent.com/jongio/grut/main/install.ps1 | iex

To install a specific version:

$v="v0.1.0"; irm https://raw.githubusercontent.com/jongio/grut/main/install.ps1 | iex

go install github.com/jongio/grut@latest

Download from GitHub Releases.

grut update  # Downloads and installs the latest release

grut              # Launch file explorer in current directory
grut /path/to/dir # Open specific directory
grut update       # Update grut to the latest release
grut version      # Print the version

A background update check runs on every launch and notifies you when a new version is available.

grüt displays file-type icons using Nerd Font glyphs. For the best experience, install a Nerd Font (e.g. 0xProto, FiraCode, JetBrainsMono) and configure your terminal to use it.

When icon_mode is set to "auto" (the default), grüt detects known nerd-font-capable terminals (WezTerm, kitty, Alacritty, iTerm, Ghostty, Windows Terminal, etc.) and enables icons automatically. You can also force it:

# ~/.config/grut/config.toml
[file_tree]
icon_mode = "nerd"   # always use nerd font icons
# icon_mode = "ascii" # always use plain ASCII

Or set the environment variable GRUT_NERD_FONT=1 to enable nerd icons in any terminal.

See docs/keybindings.md for the complete reference.

Config file: ~/.config/grut/config.toml (Linux/macOS) or %APPDATA%\grut\config.toml (Windows)

See docs/configuration.md for all options.

git clone https://github.com/jongio/grut.git
cd grut
go build -o grut .
./grut

Or with Mage:

mage build

grut uses Mage for development workflows:

mage install    # Run tests, build bin/grut-dev, add to PATH (default target)
mage test       # Run all unit tests
mage preflight  # Pre-commit checks: fmt, tidy, vet, build, test, vulncheck
mage vet        # Run go vet
mage lint       # Run golangci-lint (falls back to go vet)
mage fmt        # Format all Go source files
mage clean      # Remove bin/ directory

You can also use standard Go commands directly:

go build ./...   # Build all packages
go test ./...    # Run all tests
go vet ./...     # Vet all packages

• Go 1.26.3 + Bubble Tea v2 (TUI) + Lipgloss v2 (styling) + Bubbles v2 (widgets)
• Chroma v2 (syntax highlighting) + Glamour (markdown rendering)
• fsnotify (filesystem watching) + mimetype (file type detection)
• TOML configuration via go-toml/v2
• Cobra CLI framework

MIT