serie

Rich git commit graph in your terminal

TLDR

Display the commit graph for the current repository

$ serie

Limit display to a number of commits

$ serie -n [100]

Use topological commit ordering

$ serie -o topo

Use angular edge style with double-width cells

$ serie -s angular --graph-width double

serie renders rich git commit graphs directly in the terminal using terminal image protocols (iTerm2 inline images or Kitty graphics). It provides a visual alternative to git log --graph --all with customizable graph styles, commit ordering, and interactive browsing. Press ? inside the TUI to view the keybinding cheat sheet.

PARAMETERS

-n, --max-count NUMBER

Maximum number of commits to render.

-p, --protocol TYPE

Image protocol: auto, iterm, kitty, or kitty-unicode. Default: auto.

-o, --order TYPE

Commit ordering: chrono or topo. Default: chrono.

-g, --graph-width TYPE

Cell width: auto, double, or single.

-s, --graph-style TYPE

Edge style: rounded or angular.

-i, --initial-selection TYPE

Commit selected on startup: latest or head.

-h, --help

Show help text and exit.

-V, --version

Print version and exit.

CONFIGURATION

$SERIE_CONFIG_FILE

Path to a TOML configuration file. Falls back to $XDG_CONFIG_HOME/serie/config.toml when unset.

CAVEATS

Requires a terminal that supports the iTerm2 inline images protocol or the Kitty graphics protocol. Sixel graphics are not supported, and rendering does not work reliably inside terminal multiplexers (tmux, screen, Zellij) that strip image escape sequences.

HISTORY

serie was created by Kyosuke Fujimoto (lusingander) and is written in Rust.