# tuicr
**A code review TUI with vim keybindings. Export to GitHub or clipboard.**
[](https://crates.io/crates/tuicr)
[](./LICENSE)
[](https://tuicr.dev)
> [!TIP]
> Pronounced "tweaker".
## What it does
- GitHub-style continuous diff in the terminal. Scroll through every changed file in one stream.
- PR-style comments at the line, range, file, and review level, with classifications like
`issue`, `suggestion`, `note`, and `praise`.
- Three export targets: push a real PR review to GitHub, copy structured markdown to your
clipboard, or pipe to stdout.
- Works with git, jj, and mercurial. Reviews uncommitted changes, commit ranges, or any GitHub PR.
## Install
```bash
brew install agavra/tap/tuicr
```
<details>
<summary>Other install methods (cargo, mise, nix, binaries, source)</summary>
```bash
# Cargo
cargo install tuicr
# Mise
mise use github:agavra/tuicr
# Nix
nix run github:agavra/tuicr
```
Pre-built binaries: [GitHub Releases](https://github.com/agavra/tuicr/releases)
From source:
```bash
git clone https://github.com/agavra/tuicr.git
cd tuicr
cargo install --path .
```
</details>
## Quick start
```bash
tuicr # Pick from a commit selector
tuicr -w # Uncommitted changes (skip selector)
tuicr -r main..HEAD # Commit range
tuicr pr 125 # GitHub PR
tuicr --stdout # Pipe the review to stdout
```
Inside tuicr, navigate with `j`/`k`, press `c` to comment, then `y` to copy the review or
`:submit` to push it to GitHub. Auto-detects git, jj, or mercurial.
## How it compares
| TUI diff viewer | ✅ | ✅ | ✅ | ❌ | ❌ |
| Write comments in the TUI | ✅ | ✅ | ✅ | ❌ | ❌ |
| Vim keybindings | ✅ | ❌ | partial¹ | ❌ | ❌ |
| Push inline review to GitHub | ✅ | ❌ | ❌ | partial² | ❌ |
| Agent-ready markdown export | ✅ | via CLI skill | ❌ | ❌ | ❌ |
| git | ✅ | ✅ | ✅ | ❌ | ✅ |
| jj | ✅ | ✅ | ✅ | ❌ | ❌ |
| Mercurial (hg) | ✅ | ❌ | ❌ | ❌ | ❌ |
| Single static binary | ✅ | (needs Node) | ✅ | ✅ | ✅ |
¹ Lumen has `j`/`k` navigation but no broader vim model (visual mode, `{N}G`, `Ctrl-d`/`Ctrl-u`,
etc.).
² `gh pr review` posts approve/comment/request-changes at the review level only. No inline line
comments.
## Export your review
When you're done reviewing, send your comments wherever the work continues.
### To GitHub
`:submit` opens a picker for Comment, Approve, Request changes, or Draft. Inline comments land
on the right lines as a real PR review; review-level comments become the review summary.
Requires `gh` authenticated to the repo.
### To your coding agent
`y` or `:clip` copies a structured markdown block to your clipboard. Each comment has a number,
a classification, and a file/line anchor:
```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
```
Paste it back to any coding agent (Claude, Codex, Cursor, etc).
For an agent-driven workflow where your agent opens tuicr in a tmux split pane, see
[skills/tuicr/SKILL.md](skills/tuicr/SKILL.md).
### To stdout
Run with `--stdout` to pipe the markdown to another process:
```bash
tuicr --stdout > review.md
tuicr --stdout | pbcopy
```
## Configuration
Path: `~/.config/tuicr/config.toml` on Linux/macOS, `%APPDATA%\tuicr\config.toml` on Windows.
```toml
theme = "catppuccin-mocha"
diff_view = "side-by-side" # or "unified"
appearance = "system" # or "dark" / "light"
mouse = true
leader = ";" # configurable prefix for leader shortcuts
[[comment_types]]
id = "issue"
color = "red"
definition = "must fix before merge"
```
Themes: `dark`, `light`, `ayu-light`, `ayu-mirage`, `onedark`, `github-light`, `github-dark`,
`catppuccin-latte`, `catppuccin-frappe`, `catppuccin-macchiato`, `catppuccin-mocha`,
`everforest-dark`, `everforest-light`, `gruvbox-dark`, `gruvbox-light`, `nord-dark`,
`nord-light`, `nord-dark-high-contrast`, `nord-light-high-contrast`, `solarized-light`,
`solarized-dark`, `tokyo-night-storm`.
Full options, theme resolution precedence, `comment_types` semantics, and `.tuicrignore` rules in
[docs/CONFIG.md](docs/CONFIG.md).
## Keybindings
A first-session cheatsheet. Press `?` inside tuicr for the full reference.
| `j` / `k` | Down / up |
| `Ctrl-d` / `Ctrl-u` | Half-page down / up |
| `g` / `G` | Top / bottom |
| `{` / `}` | Previous / next file |
| `[` / `]` | Previous / next hunk |
| `/` | Search |
| `c` / `C` | Add line / file comment |
| `v` / `V` | Visual mode (range comment) |
| `r` | Toggle file reviewed |
| `y` | Copy review to clipboard |
| `:submit` | Push review to GitHub |
| `?` | Toggle full help |
Full reference in [docs/KEYBINDINGS.md](docs/KEYBINDINGS.md).
## Sponsors
Thanks to the folks below for keeping tuicr development going, it means a lot to have the
work I'm doing here appreciated!
<p>
<a href="https://www.coderabbit.ai/">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./public/sponsors/coderabbit-dark.svg">
<img src="./public/sponsors/coderabbit-light.svg" alt="CodeRabbit" height="40">
</picture>
</a>
</p>
## License
MIT licensed. Contribution notes in [CONTRIBUTING.md](CONTRIBUTING.md).