- Features
- Motivation
- Benchmarks
- Roadmap
- Limitations
- Installation
- Build
- Diagnostics
- Color Theme
- Key Bindings
- Sponsoring
- Inspiration
1. Features Top ▲
- Fast and intuitive keyboard only control
- Context based help (no need to memorize tons of hot-keys)
- Inspect, commit, and amend changes (incl. hooks: commit-msg/post-commit)
- Stage, unstage, revert and reset files, hunks and lines
- Stashing (save, pop, apply, drop, and inspect)
- Push/Fetch to/from remote
- Branch List (create, rename, delete, checkout, remotes)
- Browse commit log, diff committed changes
- Scalable terminal UI layout
- Async git API for fluid control
2. Motivation Top ▲
I do most of my git work in a terminal but I frequently found myself using git GUIs for some use-cases like: index, commit, diff, stash, blame and log.
Unfortunately popular git GUIs all fail on giant repositories or become unresponsive and unusable.
GitUI provides you with the user experience and comfort of a git GUI but right in your terminal while being portable, fast, free and opensource.
3. Benchmarks Top ▲
For a RustBerlin meetup presentation (slides) I compared lazygit
,tig
and gitui
by parsing the entire Linux git repository (which contains over 900k commits):
Time | Memory (GB) | Binary (MB) | Freezes | Crashes | |
---|---|---|---|---|---|
gitui |
24 s ✅ | 0.17 ✅ | 1.4 | No ✅ | No ✅ |
lazygit |
57 s | 2.6 | 16 | Yes | Sometimes |
tig |
4 m 20 s | 1.3 | 0.6 ✅ | Sometimes | No ✅ |
4. Road(map) to 1.0 Top ▲
These are the high level goals before calling out 1.0
:
- log search (commit, author, sha) (#449,#429)
- file history log (#381)
- visualize branching structure in log tab (#81)
5. Known Limitations Top ▲
- no support for bare repositories (see #100)
- no support for core.hooksPath config
- no support for GPG signing (see #97)
Currently, this tool does not fully substitute the git shell, however both tools work well in tandem.
gitui
currently lacks essential features in git like push, pull, and checkout. The priorities are the basics (add, commit), and on features that are making me mad when done on the git shell, like stashes and hunks. Eventually, I will be able to work on features that could lead to making gitui
a one stop solution to get rid of the shell entirely - but for that I need help - this is just a spare time project right now.
All support is welcomed! Sponsors as well! ❤️
6. Installation Top ▲
For the time being this product is in alpha and is not considered production ready. However, for personal use it is reasonably stable and is being used while developing itself.
pacman -S gitui
sudo dnf install gitui
Available in dm9pZCAq overlay
sudo eselect repository enable dm9pZCAq
sudo emerge --sync dm9pZCAq
sudo emerge dev-vcs/gitui::dm9pZCAq
brew install gitui
Scoop (Windows)
scoop install gitui
Chocolatey (Windows)
choco install gitui
Nix (Nix/NixOS)
Nixpkg
nix-env -iA nixpkgs.gitui
NixOS
nix-env -iA nixos.gitui
Available for download in releases
Binaries available for:
- Linux
- macOS
- Windows
7. Build Top ▲
- Latest
rust
andcargo
- See Install Rust
The simplest way to start playing around with gitui
is to have cargo
build and install it with cargo install gitui
8. Diagnostics Top ▲
To run with logging enabled run gitui -l
.
This will log to:
- macOS:
$HOME/Library/Caches/gitui/gitui.log
- Linux using
XDG
:$XDG_CACHE_HOME/gitui/gitui.log
- Linux:
$HOME/.cache/gitui/gitui.log
- Windows:
%LOCALAPPDATA%/gitui/gitui.log
9. Color Theme Top ▲
gitui
should automatically work on both light and dark terminal themes.
However, you can customize everything to your liking: See Themes.
10. Key Bindings Top ▲
The key bindings can be customized: See Key Config on how to set them to vim
-like bindings.
11. Sponsoring Top ▲
12. Inspiration Top ▲
- lazygit
- tig
- GitUp
- It would be nice to come up with a way to have the map view available in a terminal tool
- git-brunch