Repolode
Submit
unhappychoice

unhappychoice/gitlogue

A terminal tool that replays Git commits as animated typing sessions with syntax highlighting and file tree transitions.

View on GitHub
Stars
5,162
Forks
120
Open issues
9
Last commit
3 days ago

What is it?

gitlogue replays Git commits in the terminal as animations. It simulates realistic typing, cursor movement, deletions and file operations, so a commit's code changes unfold step by step instead of appearing as a static diff.

The tool supports single commits, commit ranges, chronological ordering, looping, and watch mode that replays new commits as they are made. It also offers a working tree diff view for staged or unstaged changes, filters by author and date, and per-file-type typing speeds. Syntax highlighting uses tree-sitter across 32 languages, and a project file tree shows change statistics.

It can run as an endless screensaver-style display, with 9 built-in themes and configuration through a TOML file. Installation is available via install script, Homebrew, Cargo, Arch Linux packages and Nix.

Key features

  • 01Replays commits with realistic typing, cursor movement and file operations
  • 02Tree-sitter syntax highlighting for 32 languages
  • 03Project file tree with change statistics
  • 04Working tree diff view for staged or unstaged changes
  • 05Filters by author and date, plus watch mode for new commits
  • 069 built-in themes with customization

Use cases

  • Ambient coding display on a workspace terminal
  • Teaching how a codebase evolved over time
  • Presenting real commit histories in live demos
  • Recording terminal demo videos with VHS or asciinema

Quick start

  1. 1

    Install with Cargo

    cargo install gitlogue
  2. 2

    Run the screensaver in a Git repository

    gitlogue
  3. 3

    View a specific commit

    gitlogue --commit abc123

Things to know

  • Requires a terminal environment to display its animations.

Topics

#git#terminal#tui#rust#cli#syntax-highlighting#visualization#commit-history#cli-tool#code-animation

FAQ

What is gitlogue?
A terminal tool that replays Git commits as animated typing sessions with syntax highlighting and file tree transitions. gitlogue replays Git commits in the terminal as animations. It simulates realistic typing, cursor movement, deletions and file operations, so a commit's code changes unfold step by step instead of appearing as a static diff.
Is gitlogue free to use? What license does it have?
gitlogue is open source under the ISC license. Check the license terms before using it in commercial products.
Is gitlogue still maintained?
Actively maintained. The last commit to gitlogue was on Oct 17, 2026.
What can I use gitlogue for?
Ambient coding display on a workspace terminal Teaching how a codebase evolved over time Presenting real commit histories in live demos Recording terminal demo videos with VHS or asciinema
How do I install gitlogue?
Install with Cargo: cargo install gitlogue Run the screensaver in a Git repository: gitlogue View a specific commit: gitlogue --commit abc123
Where can I get gitlogue?
The source code and installation instructions are on GitHub: https://github.com/unhappychoice/gitlogue

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects