Show HN: Serie – A rich Git commit graph in your terminal

4 days ago 1

A rich git commit graph in your terminal, like magic 📚

(This demo shows Ratatui repository!)

Serie (/zéːriə/) is a TUI application that uses the terminal emulators' image display protocol to render commit graphs like git log --graph --all.

While some users prefer to use Git via CLI, they often rely on a GUI or feature-rich TUI to view commit logs. Others may find git log --graph sufficient.

Personally, I found the output from git log --graph difficult to read, even with additional options. Learning complex tools just to view logs seemed cumbersome.

Provide a rich git log --graph experience in the terminal.
Offer commit graph-centric browsing of Git repositories.

Implement a fully-featured Git client.
Create a TUI application with a complex UI.
Works in any terminal environment.

Git
Supported terminal emulator
- Refer to Compatibility for details.

$ cargo install --locked serie

or from tap:

$ brew install lusingander/tap/serie

You can download pre-compiled binaries from releases.

If you want to check the latest development version, build from source:

$ git clone https://github.com/lusingander/serie.git $ cd serie $ cargo build --release # Unless it's a release build, it's very slow. $ ./target/release/serie

Run serie in the directory where your git repository exists.

$ cd <your git repository> $ serie

Serie - A rich git commit graph in your terminal, like magic 📚 Usage: serie [OPTIONS] Options: -p, --protocol <TYPE> Image protocol to render graph [default: auto] [possible values: auto, iterm, kitty] -o, --order <TYPE> Commit ordering algorithm [default: chrono] [possible values: chrono, topo] -g, --graph-width <TYPE> Commit graph image cell width [default: auto] [possible values: auto, double, single] --preload Preload all graph images -h, --help Print help -V, --version Print version

A protocol type for rendering images of commit graphs.

By default auto will guess the best supported protocol for the current terminal (if listed in Supported terminals).

--order chrono will order commits by commit date if possible.

--order topo will order commits on the same branch consecutively if possible.

Screenshots

--order chrono

--order topo

The character width that a graph image unit cell occupies.

If not specified or auto is specified, double will be used automatically if there is enough width to display it, single otherwise.

Screenshots

--graph-width double

--graph-width single

By default, graph images are generated and loaded lazily as needed.

If --preload is specified, all graph images will be generated and loaded at startup. This can result in smoother scrolling, as the images are already available, and might reduce memory usage. However, this may lead to slower startup times, especially for large repositories.

You can see the keybindings by pressing the ? key.

The default key bindings can be overridden. Please refer to default-keybind.toml and add it to config file.

List of all default keybindings Key Description Corresponding keybind

Ctrl-c q	Quit app	force_quit quit
?	Open help	help_toggle