Blazing 💥 fast terminal-ui for git written in rust 🦀
Go to file
dependabot[bot] c6e7a55fbf Bump clap from 4.0.23 to 4.0.25
Bumps [clap](https://github.com/clap-rs/clap) from 4.0.23 to 4.0.25.
- [Release notes](https://github.com/clap-rs/clap/releases)
- [Changelog](https://github.com/clap-rs/clap/blob/master/CHANGELOG.md)
- [Commits](https://github.com/clap-rs/clap/compare/v4.0.23...v4.0.25)

---
updated-dependencies:
- dependency-name: clap
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-11-16 07:19:06 +01:00
.cargo Add Linux targets for ARM, ARMv7 and AARCH64 (#1419) 2022-11-05 16:46:11 +01:00
.github Add Linux targets for ARM, ARMv7 and AARCH64 (#1419) 2022-11-05 16:46:11 +01:00
.vscode cargo fmt: use hardtabs 2021-08-17 14:24:25 +02:00
assets feature gif 2022-10-24 16:33:58 +02:00
asyncgit Fix Clippy Lints (#1390) 2022-10-19 13:45:12 +02:00
filetreelist fix nightly clippy 2022-11-05 16:33:48 +01:00
invalidstring fix rust clippy 2022-10-26 14:34:33 +02:00
scopetime msrv 160 (#1279) 2022-08-17 16:30:54 +02:00
src nightly clippy fix 2022-11-14 15:04:48 +01:00
wix change author name 2022-02-21 23:33:07 +01:00
.clippy.toml msrv 160 (#1279) 2022-08-17 16:30:54 +02:00
.gitignore add vc runtime to wix / msi package (#431) 2020-12-08 00:03:27 +01:00
Cargo.lock Bump clap from 4.0.23 to 4.0.25 2022-11-16 07:19:06 +01:00
Cargo.toml cargo sort 2022-11-14 16:08:42 +01:00
CHANGELOG.md Edit file from file tree (#1430) 2022-11-14 15:01:34 +01:00
demo.gif cleanup cargo deplyment 2021-04-11 23:06:39 +02:00
deny.toml File watching using notify (#1310) 2022-09-02 09:59:13 +02:00
FAQ.md added faq page 2022-04-24 18:58:50 +02:00
KEY_CONFIG.md fix h for help keybinding in keyconfig example 2022-01-09 17:00:04 +01:00
LICENSE.md change author name 2022-02-21 23:33:07 +01:00
Makefile Add Linux targets for ARM, ARMv7 and AARCH64 (#1419) 2022-11-05 16:46:11 +01:00
README.md Add a Readme entry for Winget-based installation (#1337) 2022-09-18 14:09:19 +02:00
rust-toolchain.toml Generate rust toolchain file (#1401) 2022-10-25 09:17:37 +02:00
rustfmt.toml cargo fmt: use hardtabs 2021-08-17 14:24:25 +02:00
THEMES.md Add link from themes.md to referenced code block 2022-10-20 16:30:15 +02:00
vim_style_key_config.ron add gg/G to vim config (#1041) 2021-12-12 18:14:02 +01:00

CI crates MIT UNSAFE ITCH DISC TWEET

GitUI provides you with the comfort of a git GUI but right in your terminal

Table of Contents

  1. Features
  2. Motivation
  3. Benchmarks
  4. Roadmap
  5. Limitations
  6. Installation
  7. Build
  8. FAQs
  9. Diagnostics
  10. Color Theme
  11. Key Bindings
  12. Sponsoring
  13. 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: pre-commit,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
  • Submodule support

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)
  • visualize branching structure in log tab (#81)
  • interactive rebase (#32)

5. Known Limitations Top ▲

  • no sparse repo support (see #1226)
  • no support for GPG signing (see #97)
  • no git-lfs support (see #1089)
  • credential.helper for https needs to be explicitly configured (see #800)

Currently, this tool does not fully substitute the git shell, however both tools work well in tandem.

The priorities for gitui are on features that are making me mad when done on the git shell, like stashing, staging lines or hunks. Eventually, I will be able to work on making gitui a one stop solution - but for that I need help - this is just a spare time project for 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.

Arch Linux

pacman -S gitui

Fedora

sudo dnf install gitui

Gentoo

Available in dm9pZCAq overlay

sudo eselect repository enable dm9pZCAq
sudo emerge --sync dm9pZCAq
sudo emerge dev-vcs/gitui::dm9pZCAq

Homebrew (macOS)

brew install gitui

MacPorts (macOS)

port install gitui

Winget (Windows)

winget 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

Termux (Android)

pkg install gitui

Release Binaries

Available for download in releases

Binaries available for:

  • Linux
  • macOS
  • Windows

7. Build Top ▲

Requirements

  • Minimum supported rust/cargo version: 1.60

Cargo Install

The simplest way to start playing around with gitui is to have cargo build and install it with cargo install gitui. If you are not familiar with rust and cargo: Getting Started with Rust

Cargo Features

trace-libgit

enable libgit2 tracing

works if libgit2 builded with -DENABLE_TRACE=ON

this feature enabled by default, to disable: cargo install --no-default-features

8. FAQs Top ▲

see FAQs page

9. 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

10. Color Theme Top ▲

gitui should automatically work on both light and dark terminal themes.

However, you can customize everything to your liking: See Themes.

11. Key Bindings Top ▲

The key bindings can be customized: See Key Config on how to set them to vim-like bindings.

12. Sponsoring Top ▲

github

13. Inspiration Top ▲