# tuicr: TUI for Code Review
<a href="https://crates.io/crates/tuicr" target="_blank"><img src="https://img.shields.io/crates/v/tuicr" alt="Crates.io"></a>
<a href="https://github.com/agavra/tuicr/blob/main/LICENSE" target="_blank"><img src="https://img.shields.io/crates/l/tuicr" alt="License"></a>
<a href="https://tuicr.dev" target="_blank"><img src="https://img.shields.io/badge/website-tuicr.dev-green" alt="Website"></a>
Review AI-generated diffs like a GitHub pull request, right from your terminal.
## Why I built this
I use Claude a lot but there's no middle ground between "review every change"
and "accept all edits". Reviewing every change slows things down to human speed,
but accepting all edits makes the final review painful since I end up leaving
comments one at a time and wait after each fix.
`tuicr` is the middle ground. Let the agent loose, review the changes like a
normal PR, drop comments where needed, and export everything as structured
feedback Claude can act on in one pass.
It makes my AI-assisted development go brrrrrr.
> [!TIP]
> I pronounce it "tweaker"
## Overview
A GitHub-style diff viewer in your terminal with vim keybindings. Scroll through
changed files, leave comments, mark files as reviewed, and copy your full review
to clipboard in a format ready to paste back to the agent.
## Features
- **Infinite scroll diff view** - All changed files in one continuous scroll (GitHub-style)
- **Vim keybindings** - Navigate with `j/k`, `Ctrl-d/u`, `g/G`, `{/}`, `[/]`
- **Expandable context** - Press Enter on "... expand (N lines) ..." to reveal hidden context between hunks
- **Comments** - Add file-level or line-level comments with types
- **Visual mode** - Select line ranges with `v` / `V` and comment on multiple lines at once
- **Review tracking** - Mark files as reviewed, persist progress to disk
- **Clipboard export** - Copy structured Markdown optimized for LLM consumption
- **Session persistence** - Reviews auto-save and reload on restart
- **Jujutsu support** - Built-in jj support (tried first since jj repos are Git-backed)
- **Mercurial support** - Built-in hg support
## Installation
### Homebrew (macOS/Linux)
```bash
brew install agavra/tap/tuicr
```
### Pre-built binaries
Download the latest release for your platform from [GitHub Releases](https://github.com/agavra/tuicr/releases).
### Mise (macOS/Linux/Windows)
```
mise use github:agavra/tuicr
```
### From crates.io
```bash
cargo install tuicr
```
### From source
```bash
git clone https://github.com/agavra/tuicr.git
cd tuicr
cargo install --path .
```
## Usage
Run `tuicr` in any git, jujutsu, or mercurial repository:
```bash
cd /path/to/your/repo
tuicr
```
Detection order: Jujutsu → Git → Mercurial. Jujutsu is tried first because jj repos are Git-backed.
### Options
| `--theme dark` | Use dark color theme (default) |
| `--theme light` | Use light color theme for light terminal backgrounds |
| `--stdout` | Output to stdout instead of clipboard when exporting |
| `--no-update-check` | Skip checking for updates on startup |
### Keybindings
#### Navigation
| `j` / `↓` | Scroll down |
| `k` / `↑` | Scroll up |
| `h` / `←` | Scroll left |
| `l` / `→` | Scroll right |
| `Ctrl-d` / `Ctrl-u` | Half page down/up |
| `Ctrl-f` / `Ctrl-b` | Full page down/up |
| `g` / `G` | Go to first/last file |
| `{` / `}` | Jump to previous/next file |
| `[` / `]` | Jump to previous/next hunk |
| `/` | Search within diff |
| `n` / `N` | Next/previous search match |
| `Enter` | Expand/collapse hidden context between hunks |
| `zz` | Center cursor on screen |
#### File Tree
| `Space` | Toggle expand directory |
| `Enter` | Expand directory / Jump to file in diff |
| `o` | Expand all directories |
| `O` | Collapse all directories |
#### Panel Focus
| `Tab` | Toggle focus between file list and diff |
| `;h` | Focus file list (left panel) |
| `;l` | Focus diff view (right panel) |
| `;e` | Toggle file list visibility |
| `Enter` | Select file (when file list is focused) |
#### Review Actions
| `r` | Toggle file reviewed |
| `c` | Add line comment (or file comment if not on a diff line) |
| `C` | Add file comment |
| `v` / `V` | Enter visual mode for range comments |
| `dd` | Delete comment at cursor |
| `i` | Edit comment at cursor |
| `y` | Copy review to clipboard |
#### Visual Mode
| `j` / `k` | Extend selection down/up |
| `c` / `Enter` | Create comment for selected range |
| `Esc` / `v` / `V` | Cancel selection |
#### Comment Mode
| `Tab` | Cycle comment type (Note → Suggestion → Issue → Praise) |
| `Enter` / `Ctrl-Enter` / `Ctrl-s` | Save comment |
| `Shift-Enter` / `Ctrl-j` | Insert newline |
| `←` / `→` | Move cursor |
| `Ctrl-w` | Delete word |
| `Ctrl-u` | Clear line |
| `Esc` / `Ctrl-c` | Cancel |
#### Commands
| `:w` | Save session |
| `:e` (`:reload`) | Reload diff files |
| `:clip` (`:export`) | Copy review to clipboard |
| `:diff` | Toggle diff view (unified / side-by-side) |
| `:commits` | Select commits to review |
| `:set wrap` | Enable line wrap in diff view |
| `:set wrap!` | Toggle line wrap in diff view |
| `:clear` | Clear all comments |
| `:version` | Show tuicr version |
| `:update` | Check for updates |
| `:q` | Quit (warns if unsaved) |
| `:q!` | Force quit |
| `:x` / `:wq` | Save and quit (prompts to copy if comments exist) |
| `?` | Toggle help |
| `q` | Quick quit |
#### Commit Selection (when no unstaged changes)
| `j` / `k` | Move selection |
| `Space` | Toggle commit selection |
| `Enter` | Confirm and load diff |
| `q` / `Esc` | Quit |
#### Confirm Dialogs
| `y` / `Enter` | Yes |
| `n` / `Esc` | No |
## Review Output
When you export your review (`:clip` or confirm on `:wq`), `tuicr` copies structured Markdown to your clipboard. The format is optimized for pasting into AI agent conversations:
```markdown
I reviewed your code and have the following comments. Please address them.
Comment types: ISSUE (problems to fix), SUGGESTION (improvements), NOTE (observations), PRAISE (positive feedback)
1. **[SUGGESTION]** `src/auth.rs` - Consider adding unit tests
2. **[ISSUE]** `src/auth.rs:42` - Magic number should be a named constant
3. **[NOTE]** `src/auth.rs:50-55` - This block could be refactored
```
Each comment is numbered and self-contained with its file path and line number or range (if applicable).
## Session Persistence
Sessions are automatically saved to `~/.local/share/tuicr/reviews/` (XDG compliant). When you reopen `tuicr` in the same repository, your previous review progress (comments, reviewed status) is restored.
## Claude Code Integration
tuicr includes a skill for [Claude Code](https://claude.ai/claude-code) that opens tuicr in a tmux split pane, letting you review changes interactively and feed comments back to Claude.
**Prerequisites:** Claude Code running inside tmux, tuicr installed.
**Installation** (choose one):
```bash
# Option 1: Copy to local skills
cp -r /path/to/tuicr/.claude/skill ~/.claude/skills/tuicr
# Option 2: Point Claude to this repo
claude skill add /path/to/tuicr/.claude/skill
```
**Usage:** `/tuicr` or ask Claude to "review my changes with tuicr".