gitui

gitui [options]

gitui is a fast terminal UI for Git. It provides a keyboard-driven interface for staging, committing, branching, and viewing diffs, all within the terminal.Written in Rust, gitui is lightweight and responsive. It displays status, log, diff, and staging information in a split-pane interface with vim-like key bindings.

-d PATH, --directory PATH

Set the git directory (defaults to `.` or `$GIT_DIR`).

Set the working directory (defaults to the current directory or `$GITWORKTREE`).

Set the color theme filename, loaded from the config directory (default: `theme.ron`).

Select a file in the file tab on startup.

Use a custom keybindings file.

Use a custom symbols file.

Store logging output into a file in the cache directory.

Store logging output into the specified file (implies --logging).

Use a notify-based file system watcher instead of the default tick-based polling.

Generate a bug report.

Display help information.

Display version information.

~/.config/gitui/theme.ron

Theme configuration file in RON format for customizing colors and appearance.

Key binding customization file.

Terminal UI needs appropriate terminal. Some features limited compared to full GUI. Themes require RON format. By default, gitui polls the working directory for changes every few seconds; pass --watcher for faster, notify-based change detection on platforms where it works reliably.

gitui was created by Stephan Dilly as a fast, keyboard-centric terminal UI for git written in Rust.

tig(1), lazygit(1), git-gui(1)

Source code · FAQ