install

Additional install commands

macOS

Homebrewverified · 100%

brew install gitui

provider-native install command

overview

Package summary

Blazing fast terminal-ui for git written in rust

Project links

Homepage

Commands and aliases

gitui

history

Project history and usage

GitUI is a Rust terminal interface for Git that gives command-line users many comforts of a graphical Git client without leaving the terminal. Its emphasis is fast, keyboard-only interaction for common Git tasks such as staging, diffs, commits, branches, stashes, logs, and remotes.

Project history

The public repository was opened in March 2020, and the crate was published to crates.io shortly afterward. The README explains the motivation: the author did most Git work in a terminal but still reached for graphical clients for index, commit, diff, stash, blame, and log workflows, while some GUI clients struggled with very large repositories.

GitUI's early releases began in April 2020. The project grew around a responsive terminal UI, async Git API use, context-based help, and keyboard-only control. The README's benchmark section compared parsing the Linux repository against lazygit and tig in a RustBerlin presentation, positioning performance on large repositories as part of its identity.

As the project matured, customization became a first-class part of its package surface. Separate docs describe RON-based theme files, key bindings, and key-symbol overrides, with platform-specific config locations for Linux, macOS, and Windows.

Adoption history

GitUI has broad package-manager reach for a terminal Git client. The README lists Arch Linux, Fedora, openSUSE, Homebrew, MacPorts, WinGet, Scoop, Chocolatey, mise, Nix, Termux, Anaconda, Cargo, and release binaries. crates.io records the crate, repository, and download data, while Homebrew packages it as a stable formula.

That packaging spread reflects the tool's practical niche: it is installed globally by developers who want a fast Git workbench available in any repository, independent of an editor plugin or desktop GUI.

How it is used

Practitioners launch `gitui` inside a Git repository to inspect status, stage or unstage files and hunks, commit or amend, manage stashes, browse and search logs, push or fetch remotes, and work with branches. The README notes that GitUI complements the Git shell rather than fully replacing it.

Customization workflows center on `theme.ron`, `key_bindings.ron`, and `key_symbols.ron`. Users tune colors, syntax themes, navigation keys, and displayed key symbols while keeping the main workflow terminal-native.

Why package nerds care

GitUI is one of the better-known Rust Git TUIs and a useful example of a single-binary developer tool that package managers carry widely. It also demonstrates a common modern pattern: Git as the substrate, Rust for portable performance, and config files in XDG/AppData locations for long-term daily use.

Timeline

2020: Public GitHub repository opened.
2020: Crate publication recorded on crates.io.
2020: Early GitHub 0.1 releases published.
2025: README documented a 1.0 roadmap and extensive package-manager install options.
2026: 0.28 release line visible in GitHub releases.

Related projects

Git command-line workflows.
lazygit and tig as benchmarked Git TUI peers.
Rust terminal UI and crossterm/ratatui-style configuration ecosystems.
Homebrew, Cargo, Nix, Scoop, WinGet, and distro package collections.

Sources

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

narrow executable package without higher-risk signals

Signals

metadata:no-higher-risk-signals

Install behavior

No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Linux: $XDG_CONFIG_HOME/gitui/theme.ron~/.config/gitui/theme.ron$XDG_CONFIG_HOME/gitui/key_bindings.ron~/.config/gitui/key_bindings.ron$XDG_CONFIG_HOME/gitui/key_symbols.ron~/.config/gitui/key_symbols.ron
macOS: ~/.config/gitui/theme.ron~/.config/gitui/key_bindings.ron~/.config/gitui/key_symbols.ron
Windows: %APPDATA%/gitui/theme.ron%APPDATA%/gitui/key_bindings.ron%APPDATA%/gitui/key_symbols.ron

executables

Installed executables

Command	Kind	Exposure	Note
`gitui`	executable	indexed executable	Discovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03

manager version0.28.1

manager updated2026-06-22

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:gitui
Version	0.28.1
Package manager	Homebrew
Homepage	https://github.com/gitui-org/gitui
Repository	https://github.com/gitui-org/gitui
Last updated	2026-06-22T14:03:33-07:00
Pulse	updated
Bottle	not recorded
Service	none declared

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/gitui.yml

Used sources

Geiger risk classifier
Nucleus package database
curated configuration and credential file locations
curated package history
pkgdb category and tag curation

Install gitui with Homebrew