ConfigsApr 11, 2026·2 min read

delta — Syntax-Highlighting Pager for Git Diff and Grep

delta is a syntax-highlighting pager for git, diff, grep, and rg output. Beautiful side-by-side diffs with language-aware highlighting, line numbers, and theming. Drop-in replacement for the default git pager.

TL;DR
delta replaces the default git pager with syntax-highlighted, side-by-side diffs with line numbers and themes.
§01

What it is

delta is a syntax-highlighting pager for git, diff, grep, and ripgrep output. It provides side-by-side diffs with language-aware highlighting, line numbers, and customizable themes. It is a drop-in replacement for the default git pager.

delta targets developers who review diffs frequently and want a more readable experience than plain text. It understands language syntax, so changes in Python look different from changes in YAML, and inline changes within a line are highlighted precisely.

The project is actively maintained and suitable for both individual developers and teams looking to integrate it into their existing toolchain. Documentation and community support are available for onboarding.

§02

How it saves time or tokens

delta makes code review faster by highlighting exactly what changed within each line, not just which lines changed. Side-by-side mode shows old and new code simultaneously. Language-aware highlighting means you can quickly parse the syntax of changed code without opening it in an editor.

§03

How to use

  1. Install delta via Homebrew (brew install git-delta), apt, or download from GitHub releases.
  2. Configure git to use delta as the pager by adding settings to ~/.gitconfig.
  3. Run git diff, git log -p, or git show as usual. delta activates automatically.
  4. Customize themes and display options in your gitconfig.
§04

Example

# ~/.gitconfig
[core]
    pager = delta

[interactive]
    diffFilter = delta --color-only

[delta]
    navigate = true
    side-by-side = true
    line-numbers = true
    syntax-theme = Dracula

[merge]
    conflictstyle = diff3

[diff]
    colorMoved = default
# After configuration, just use git normally
git diff
git log -p --follow src/main.rs
git show HEAD~3
§05

Related on TokRepo

§06

Common pitfalls

  • Forgetting to install a compatible terminal. delta uses 24-bit color. Terminals that do not support true color show garbled output. Use iTerm2, Alacritty, Kitty, or Windows Terminal.
  • Not setting navigate = true. Without it, you cannot use n/N to jump between diff sections, losing one of delta's best navigation features.
  • Using delta with a light terminal theme but a dark syntax theme (or vice versa). Match your delta syntax-theme to your terminal background for readability.
  • Not reading the changelog before upgrading. Breaking changes between versions can cause unexpected failures in production. Pin your version and review release notes.

Frequently Asked Questions

Does delta slow down git operations?+

No. delta processes output after git generates it. The rendering overhead is negligible for typical diffs. For extremely large diffs (thousands of files), you may notice a slight delay.

Can I use delta with other tools besides git?+

Yes. delta works as a pager for diff, grep, and ripgrep output. Pipe any diff-formatted output to delta for syntax highlighting: `diff file1 file2 | delta`.

Which syntax themes are available?+

delta supports all themes from the bat project, which includes Dracula, Monokai, Solarized, Nord, and dozens more. Run `delta --list-syntax-themes` to see all options and preview them.

Does delta support side-by-side mode?+

Yes. Set `side-by-side = true` in your gitconfig's [delta] section. This shows old and new code in adjacent columns, which is especially useful on wide terminals.

Can I use delta in a CI pipeline?+

delta is designed for interactive terminal use. In CI pipelines, standard diff output is more appropriate since there is no terminal to render colors and formatting.

Citations (3)
  • delta GitHub— Syntax-highlighting pager for git and diff output
  • delta README— Drop-in replacement for git's default pager
  • bat GitHub— Bat syntax themes for terminal highlighting

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets