Gitui is a blazing fast terminal git interface
==============================================

Gitui is a terminal-based git user interface (TUI) that will change the way that you work with git.

Date: January 17, 2021

## GitUI

Gitui is a terminal-based git user interface (TUI) that will change the way
that you work with git.

## Works alongside the cli

I have been a long-time user of the git cli, and it's
been hard to beat, mostly because there is nothing that keeps my fingers on the
keyboard quite like it, except `gitui` which comes with some great ways to very
quickly walk through a git project.

## installation

Go to their [releases]https://github.com/extrawurst/gitui/releases) page,
download the latest build, and pop it on your PATH. I have the following
stuffed away in some install scripts to get the latest version.

_install latest release_
``` bash
GITUI_VERSION=$(curl --silent https://github.com/extrawurst/gitui/releases/latest | tr -d '"' | sed 's/^.*tag\///g' | sed 's/>.*$//g' | sed 's/^v//')
wget https://github.com/extrawurst/gitui/releases/download/v${GITUI_VERSION}/gitui-linux-musl.tar.gz -O- -q | sudo tar -zxf - -C /usr/bin/
```

## run `gitui`

It opens blazing fast.

``` bash
gitui
```

## Quick Commits

Sometimes I edit a number of files and want to commit them one at a time, this
is painful in the git cli and my main use case for `gitui`. `gitui` shows
unstaged changes at the top, staged changes on the bottom, and a diff on the
right.

![gitui status](https://images.waylonwalker.com/gitui-status.png)

## Navigate with hjkl

By default, `gitui` uses arrow keys, but simply copying
[vim_style_key_config.ron](https://github.com/extrawurst/gitui/blob/master/vim_style_key_config.ron)
to your config directory will get you vim-like keybindings.

## workflow

* pop open `gitui`,
* use **j/k** to get to the file I want to commit,
* glance at the diff to the right
* press enter to stage the file
* sc to switch focus to the saged files and commit
* write my commit message hit enter and
* q to quit

## Keybindings

```
w/s: to toggle focus between working and staged changes
j/k: to scroll each section
h/l: switch between left and right side
enter: toggle file from working or staging
c: start a commit message
p: push
: quit
```

## Other Panes

I am in the `Status [1]` pane 90% of the time, but it also has three other
panes for `Log [2]`, `Stashing [3]`, and `Stashes [4]`. I do not really use
the stashes panes, but the `Log [2]` pane is quite useful to quickly go through
the last set of commits and see the diff for each of them.

## What UI do you use for git

Let me know what ui you use for git, do you stick to the cli, use a gui, or use
a similar `TUI` interface?