``` ,, ,,
`7MM db
MM
MM ,6"Yb. M"""MMV `7MM .gP"Ya `7Mb,od8
MM 8) MM ' AMV MM ,M' Yb MM' "'
MM ,pm9MM AMV MM 8M"""""" MM
MM 8M MM AMV , MM YM. , MM
.JMML.`Moo9^Yo.AMMmmmM .JMML.`Mbmmd'.JMML.
```
[](https://github.com/maxmalkin/lazier/actions/workflows/ci.yml)
[](https://github.com/maxmalkin/lazier/releases)
[](https://www.rust-lang.org)
[](LICENSE)
A fast terminal user interface for git. Rust, [ratatui](https://ratatui.rs),
and [gitoxide](https://github.com/GitoxideLabs/gitoxide).
It does the work of [lazygit](https://github.com/jesseduffield/lazygit)
with less memory and less processor time, making it much quicker to work with in larger repos.
## Speed and memory
Less is better.
| 10 000 changed files | processor | 748 ms | **187 ms** | **~4x** |
| Refresh 12 times, 10 000 files | processor | 3477 ms | **178 ms** | **~20x** |
| Walk 300 files with diffs | processor | 1263 ms | **147 ms** | **~9x** |
| Linux kernel, 1.3M commits | scroll 2000 commits | 2196 ms | **1346 ms** | **~1.6x** |
| | peak RSS | 136 MB | **79 MB** | **~1.7x** |
| 5000-line diff | peak RSS | 27 MB | **10 MB** | **~2.7x** |
| Idle | processor | 0.3 % | **0.0 %** | — |
| Program file | | 17 MB | **3.4 MB** | **~5x** |
lazier uses less memory in every test and no processor time when you touch
no key.
A file that changes outside the program needs no walk of the whole work
tree. lazier watches the work tree and looks only at what changed, which on
the kernel repository is **150 ms** in place of **1212 ms**.
**Why it is fast.** lazygit starts a `git` process for each read and parses
the text. lazier reads the repository in its own process with gitoxide.
Worker threads do all git work, thus the screen never waits. A list shows
only the rows in view. A refresh keeps the commits that are already in
memory when HEAD did not move, and looks at the whole work tree only when
a command could have changed a file. Writes still go to the `git` command,
thus your hooks, credential helper, and GPG key continue to work.
## Install
From the source, with Rust 1.85 or later:
```sh
cargo install --git https://github.com/maxmalkin/lazier
```
Or take an archive for your platform from the
[releases page](https://github.com/maxmalkin/lazier/releases). macOS and
Linux:
```sh
tar -xzf lazier-<target>.tar.gz && sudo mv lazier /usr/local/bin/
```
Windows: unzip `lazier-x86_64-pc-windows-msvc.zip`, then put `lazier.exe` in
a directory on your `PATH`.
There are programs for macOS, Linux, and Windows, each one for the x86-64
and the ARM processor.
## Use
Run `lazier` in a git repository. Press `?` for all keys. The bar at the
bottom shows the keys for the panel in focus.
| `1` `2` `3` `4` `5` | Status, Files, Branches, Commits, Stash |
| `0` | Diff |
| `W` | Worktrees |
| `@` | Command log: each command, its result, and its time |
## Features
- **stage** by file, directory, hunk, or single line
- **commit**, **amend**, **reword**, **revert**, **cherry-pick**, **fixup**
- **absorb**: send each staged change back to the commit that wrote it
- **split** one commit into several
- **interactive rebase**, and **rebase onto** another branch
- **bisect**
- **branches**: check out, make, delete, rename, merge
- **stash**: all, untracked too, staged only, or one file
- **tags**: make and push
- **worktrees**
- **submodules**
- **reflog**, to go back to where HEAD has been
- **blame**
- take **ours** or **theirs** in a conflict
- **commit graph**, with a full-screen view
- **word-level diff**
- **file tree**, with directories you can fold
- **mark several files**, thus the next key works on each one
- **search** the commit messages
- **ignore** a file, for everybody or for yourself
- **push**, **pull**, **fetch**, and a **force push** with a lease
- **fetch in the background**, on a timer
- **command log**, with the result and the time of each command
- **run a command line** through your shell
- **mouse** and **keyboard**