turboreview 0.1.2

turboreview is a terminal code-review tool for git repositories. Review the working tree or browse the branch's commit history, with a file tree on the left and the selected diff (syntax-highlighted, adjustable context) on the right. Stage files, mark them reviewed, leave line comments — and let an AI coding agent read those comments, fix the code, and respond.

Install

Prerequisites:

• A recent stable Rust toolchain (cargo) and git. Install Rust via rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh.
• A C compiler / build toolchain — git2 (libgit2) and libz are built from source. macOS: Xcode Command Line Tools (xcode-select --install). Linux: build-essential and pkg-config.
• Linux only: X11 clipboard libraries for copy support (arboard), e.g. on Debian/Ubuntu: libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev.
• A Nerd Font set in your terminal for the file-type glyphs.

From crates.io

cargo install turboreview

The turboreview binary lands in ~/.cargo/bin — make sure that's on your PATH.

From source

git clone https://github.com/nmbr7/turboreview.git
cd turboreview
cargo install --path .          # installs the release binary to ~/.cargo/bin

Developing

cargo run -- [REPO_PATH]        # run against a repo (defaults to .)
cargo test                      # run the test suite
cargo fmt && cargo clippy       # format + lint

Updating later: re-run cargo install turboreview (add --force to overwrite an older build).

Usage

turboreview [REPO_PATH]   # defaults to the current directory
turboreview --skill       # print the AI-agent guide and exit

Run inside (or point at) any git repository.

Layout

Two views, toggled with [ / ]:

• Changes — the working tree. Left pane has two sections, ▌ Unstaged (N) and ▌ Staged (N), each a collapsible directory tree.
• Commits — the branch history. Left pane lists commits (short hash, summary, author, date, and per-commit diff stats N files +ins -del). Diff stats are computed lazily for the rows in view. The list loads 50 commits at a time; scroll to the bottom and press L to load the next page. Press Enter on a commit to drill into its changed files (diff vs the commit's first parent); Esc steps back out.

In both views:

• Left pane — Files. Each file row shows a colored status letter (A added, M modified, D deleted, R renamed), a review tick (✓ reviewed / ○ not), and a Nerd Font file-type icon. The pane can be resized or hidden entirely (see keys).
• Right pane — Diff. Syntax-highlighted code with a line-number gutter. Added/removed lines are bright with a green/red background; unchanged context lines are dimmed so changes stand out. A line cursor (highlighted row) marks where comments attach. The title shows (ctx N) or (full file). Press v for a side-by-side (split) view — old on the left, new on the right — which is remembered across sessions.
• Comments pane (toggle with C). An optional third column listing the current scope's comments grouped by status (Open / NeedsInfo / Wontfix / Resolved). Press Enter on a comment to jump to its file and line.

Press ? at any time for an in-app keybinding overlay.

Keys

In the comment input box: type freely, Enter for a newline, Ctrl-S to save, Esc to cancel. Saving an empty comment deletes it.

Staging

s on a file in the Unstaged section stages it; on a file in the Staged section it unstages it. Staging only moves changes into or out of the git index — your working-tree files are never modified. (Hunk-level staging is not yet supported.)

Comments

Press c on a diff line to attach a comment. Comments render in a bordered box directly under their line.

Each comment is anchored to its line's content plus the surrounding lines, so it follows the line when the file shifts (e.g. lines inserted above). If a comment can no longer be confidently placed, it is shown as ⚠ outdated rather than lost.

AI-agent review loop

Comments carry a status (open, resolved, wontfix, needs_info) and an optional response. An AI coding agent can close the loop:

1. Run turboreview --skill to print a guide describing the on-disk schema and workflow.
2. The agent reads the open comments, makes the requested changes, then writes a response and sets the status in the relevant comments.json.
3. Reopen turboreview — each comment box shows the agent's status badge (✓ resolved, ✗ wontfix, ? needs-info) and its response inline.

File history & search

Press H on a file's diff to enter the history overlay — it walks the commits that touched that file (newest first). { steps to an older revision, } to a newer one; } past the newest returns to the live diff, and Esc exits. While stepping, the cursor stays on the same line number, the view scrolls to keep it centered, and context is expanded (up to full file) if needed to show that line. Comments made on a past revision are stored in that commit's scope (.turboreview/commits/<sha>/).

Press / to search within the current diff (case-insensitive substring). n and N jump to the next and previous match.

Review state & storage

Reviewed flags and comments persist under <repo>/.turboreview/:

The comment log records one JSON object per comment add/edit ({path, line, scope, date, action}, where date is a YYYY-MM-DD HH:MM:SS timestamp), so an agent can read the tail to find the latest review activity. Add .turboreview/ to your .gitignore if you don't want it tracked. R hides reviewed files to declutter the list.

Display notes

File-type icons use Nerd Fonts — install a Nerd Font in your terminal for the glyphs to render correctly (otherwise you'll see fallback boxes). Code highlighting uses the bundled Catppuccin Mocha–style dark theme.