lumen

Beautiful git diff viewer, generate commits with AI, get summary of changes, all from the CLI

What is lumen?

Beautiful git diff viewer, generate commits with AI, get summary of changes, all from the CLI

Overview of lumen

What it is

Lumen is a fast terminal diff viewer and code review TUI, written in Rust. It allows users to review git diff, commits, branches, or GitHub PRs side-by-side without leaving the terminal. It ships as a single static Rust binary and stays snappy on multi-thousand-line diffs. It works with Git and Jujutsu (jj).

Key features

  • Side-by-side diff viewer with tree-sitter syntax highlighting - Review GitHub Pull Requests with lumen diff --pr 123
  • Annotate selections, hunks, or whole files - Watch mode and stacked-commit review - Optional AI commit messages and change explanations (10+ providers)

Use cases

  • Review uncommitted changes, specific commits, or changes between branches - Review GitHub Pull Requests from the terminal - Generate commit messages for staged changes using AI - Explain changes in the working directory, staged changes, or specific commit ranges - Generate Git commands from natural language queries

Getting started

Prerequisites - git installed on your system - fzf (optional)

  • Required for lumen explain --list command - mdcat (optional)
  • Required for pretty output formatting #### Installation Using Homebrew (MacOS and Linux) bash brew install jnsahaj/lumen/lumen Using Cargo bash cargo install lumen

License and pricing

The license is MIT. The project is open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/jnsahajlumen.svg)](https://yunodb.com/tools/jnsahajlumen?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/jnsahajlumen?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/jnsahajlumen.svg" alt="Featured on YunoDB" height="20"></a>