Mire

Model Independent Review Environment

Mire is a terminal-based diffing and collaborative code review tool for humans and agents.

Features

• Review worktree changes, staged changes, revisions, commits, and patch files.
• Move through every changed file in one continuous stream.
• Use unified, split, or responsive layouts with syntax and intraline highlighting.
• Create durable review files with anchored findings, attribution, and decisions.
• Exchange bounded context and findings with local agents through JSON.
• Watch Git comparisons, patches, and source-backed reviews for changes.

Installation

Mire requires Git and Rust 1.88 or newer.

git clone https://github.com/stormlightlabs/mire.git
cd mire
cargo install --path crates/cli --locked

See the installation guide for verification, updates, and uninstall instructions.

Quick start

Run Mire inside a Git worktree:

# Unstaged and untracked changes
mire

# Equivalent explicit form
mire diff

# Staged changes
mire diff --staged

# Changes since this branch diverged from main
mire diff main...HEAD

# One commit
mire show HEAD

# A patch file
mire patch changes.diff

Place repository-relative path filters after --:

mire diff main...HEAD -- src tests

Press ? in the TUI for the current keybindings. See quick start for more information.

Reviews

Capture a Git comparison in a review file, then open it:

mire review init review.json main...HEAD -- src tests
mire review review.json --watch

# Refresh without opening the TUI
mire review refresh review.json

# Report review progress without opening the TUI
mire review status review.json

A source-backed review refreshes from its recorded Git comparison. Mire keeps exact findings in place, moves only a unique content-supported match, and marks other findings stale or ambiguous. Mire assigns note identifiers and anchor fingerprints. Mutations include the review revision the caller read, so stale writes do not replace newer changes.

See Review Notes for the complete initialization, agent handoff, refresh, disposition, and export workflow.

Agent Skill

Give the review path and Mire's bundled skill to a local agent:

mire skill path

Mire installs the bundled SKILL.md when needed and prints its path. The skill tells the agent to inspect the compact manifest, expand only named context within a byte limit, and apply location-based findings.

Local development

The browser review surface lives in packages/app. See the local development guide for the full workflow with mire serve and the Vite dev server.

Documentation

• Installation
• Quick start
• Reviewing changes
• Review notes
• Watch mode
• CLI manual
• Keybindings
• Review model
• Live-session protocol

License

Mire is available under the terms of the Apache License 2.0.