Get started

Quick start

Copy Markdown

Open a Git changeset, move through it, and choose a review layout.

Run Mire inside a Git worktree. With no revision argument, diff opens unstaged and untracked worktree changes:

mire diff

Choose a changeset

Mire accepts the Git comparisons you already use:

# Staged changes
mire diff --staged

# Current branch since it diverged from main
mire diff main...HEAD

# Latest commit
mire show

Place repository-relative path filters after --:

mire diff main...HEAD -- src tests

Move through the review

The review is one continuous, multi-file stream. Use j and k to move by row, ] and [ to move by file, and } and { to move by hunk. Press Tab to switch focus between the file sidebar and the review.

Press ? at any time for the complete keybinding reference.

Adjust the view

Press 1 for a unified diff, 2 for a split diff, or 3 to let Mire choose from the terminal width. Use + and - to change the amount of surrounding context, and w to wrap long lines.

Search the full changeset with /. Press n or N to visit the next or previous match.

Keep the review current

Add --watch when you want Mire to reload after the source changes:

mire diff main...HEAD --watch

See Watch mode for refresh behavior and recovery.