claudeers.
// Uncategorized / Others

tuicr

a code review TUI with vim keybindings

// Uncategorized / Others[ cli ][ api ][ web ][ claude ]#claude#ai-tools#code-review#rust#tui#uncategorized◷ MIT$open-sourceupdated about 9 hours ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up tuicr (release-binary project) into my current project.
Found on https://claudeers.com/tuicr
Repo: https://github.com/agavra/tuicr
Homepage/docs: https://tuicr.dev/
Detected install method: release-binary → inspect the README
Category: uncategorized. Platforms: cli, api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/agavra/tuicr/releases
// or clone
git clone https://github.com/agavra/tuicr

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageRust

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

tuicr

A code review TUI with vim keybindings: review any diff like a GitHub pull request, right from your terminal.

Your own changes, a teammate's PR, or your coding agent's work: comment on lines, ranges and files, then post the review to GitHub, GitLab, Gitea, Bitbucket, Azure DevOps or Gerrit, or copy it to the clipboard for your agent.

demo

[!TIP] Pronounced "tweaker".

Why tuicr

  • One continuous diff. Every changed file scrolls past in one stream, as on a GitHub PR page.
  • PR-style comments. Comment on a line, a range, a file or the whole review, and suggest code changes.
  • Review tracking. Mark files or hunks reviewed. The marks persist across sessions.
  • git, jj and Mercurial. Uncommitted changes, commit ranges, or a forge PR/MR.
  • Two ways out. Copy numbered, agent-ready markdown, or push a real inline review to six forges.

Install

curl -fsSL tuicr.dev/install.sh | sh
# or
brew install tuicr
# or
sudo pacman -S tuicr
Other install methods (cargo, mise, nix, Home Manager, binaries, source)
cargo install tuicr                 # Cargo
mise use github:agavra/tuicr        # Mise
nix run github:agavra/tuicr         # Nix (temporary; `nix profile install` to keep it)
programs.tuicr.enable = true;       # Home Manager, see docs/CONFIG.md

Pre-built binaries: GitHub Releases. Linux releases include dynamically linked GNU and static musl variants.

From source: git clone https://github.com/agavra/tuicr.git && cd tuicr && cargo install --path .

tuicr update upgrades the active installation. See docs/CLI.md for which install methods it supports.

60-second walkthrough

tuicr -w                    # review uncommitted changes (plain `tuicr` opens a target picker)
tuicr -r main..HEAD         # or a commit range
tuicr pr 125                # or a PR/MR/change on any supported forge
  1. Scroll with j / k; jump between files with { / }.
  2. Press c on a line, type your comment, and press Enter to save it. v selects a range first.
  3. Press r to mark the file reviewed. The sidebar tracks progress.
  4. Press y to copy the review, then paste it into your coding agent. In a PR, run :submit instead to post the review on the forge.
  5. :wq saves and quits (with comments, it first offers to copy the review). Reopen the same target later and your comments and marks are still there.

Press ? at any time for the full key reference.

Using it with a coding agent

y (or :clip) copies a numbered markdown review. After tuicr -r main..HEAD, with the default settings, it looks like this:

## Session: acme/app@feature-login/commits/1a2b3c4..9f8e7d6

I reviewed your code and have the following comments. Please address them.

Reviewing commits: 9f8e7d6, 1a2b3c4

## Local tuicr Comments

1. `src/auth.rs` - Consider adding unit tests
2. `src/auth.rs:42` - Magic number should be a named constant
3. `src/auth.rs:50-55` - This block could be refactored

Paste it into any coding agent (Claude, Codex, Cursor, etc.). tuicr --stdout prints the same markdown to stdout. The [export] config section rewords or drops every line except the numbered comments, and comment_types adds **[ISSUE]**-style tags (docs/CONFIG.md).

  • Agent-launched panes. The tuicr skill lets your agent open tuicr in a cmux, Rex, tmux, Zellij or Herdr split pane, then read your comments when you are done.
  • Scripting saved reviews. tuicr review lists, reads, adds and deletes comments without opening the TUI, for example tuicr review add --session <slug> --target-file src/main.rs --line 42 "Handle the empty case". See docs/REVIEW_CLI.md. Rust tools can use the library API.

Reviewing pull requests

tuicr pr reviews the PR for the current branch, and tuicr pr <number|owner/repo#N|URL> any other one (tuicr mr is an alias). :submit opens a picker with Comment, Approve, Request changes and Draft. Inline comments land on their lines; review-level comments become the review summary.

ForgeTool / authSubmit notesGuide
GitHubgh (gh auth login)Draft leaves a pending reviewdocs/GITHUB.md
GitLabglabDraft posts draft notes; Request changes needs you as an assigned reviewerdocs/GITLAB.md
Giteatea (tea logins add)Draft leaves a pending review; ranges collapse to their last linedocs/GITEA.md
Bitbucket CloudbktDraft posts pending comments; Data Center unsupporteddocs/BITBUCKET.md
Azure DevOpsAZURE_DEVOPS_EXT_PAT, or az loginApprove / Request changes cast a vote; no drafts, so Draft posts like Comment; needs a local clonedocs/AZURE.md
GerritGERRIT_USERNAME / GERRIT_PASSWORDApprove votes Code-Review +2, Request changes -1; Draft keeps Gerrit drafts; needs a local clonedocs/GERRIT.md

Essential keys

KeyAction
j / k, Ctrl-d / Ctrl-uScroll a line / half a page
{ / }, [ / ]Previous / next file, hunk
<leader>pJump to a file by path (leader is ; by default)
c / CComment on the line / file
v / VVisual mode for a range comment (s suggests a code change)
r / RToggle file / hunk reviewed
/, n / NSearch the diff, next / previous match
yCopy the review to the clipboard
:submitPost the review to the PR's forge
:w, :wq, :qSave, save and quit, quit
?Full help

Every key and : command: docs/KEYBINDINGS.md.

Configuration

Path: ~/.config/tuicr/config.toml on Linux/macOS, %APPDATA%\tuicr\config.toml on Windows.

theme = "catppuccin-mocha"   # 24 bundled themes, or your own
diff_view = "side-by-side"   # or "unified"
editor = "nvim"              # for `e` / `:edit`; overrides $EDITOR
leader = ";"                 # prefix for leader shortcuts

[[comment_types]]            # optional; reviews are untyped by default
id = "issue"
color = "red"
definition = "must fix before merge"

All options, the theme list, local themes, Home Manager settings and .tuicrignore: docs/CONFIG.md.

How it compares

tuicrhunklumengh pr reviewgit diff
TUI diff viewer✅✅✅❌❌
Write comments in the TUI✅✅✅❌❌
Vim keybindings✅❌partial¹❌❌
Push inline review to GitHub✅❌❌partial²❌
Push inline review to GitLab, Gitea, Bitbucket, Azure DevOps, Gerrit✅❌❌❌❌
Agent-ready markdown export✅via CLI skill❌❌❌
git✅✅✅❌✅
jj✅✅✅❌❌
Mercurial (hg)✅❌❌❌❌
Standalone binary, no runtime needed✅✅✅✅✅

¹ 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.

Documentation

PageCovers
docs/CLI.mdCommands, flags, environment variables, exit codes, tuicr update, VCS backends
docs/KEYBINDINGS.mdEvery key and : command, the target selector and the Sessions tab
docs/CONFIG.mdconfig.toml options, themes, comment types, export format, .tuicrignore
docs/REVIEW_CLI.mdtuicr review for scripts and agents
docs/LIBRARY.mdThe Rust library API (ReviewStore)
docs/GITHUB.md, docs/GITLAB.md, docs/GITEA.mdForge setup, submit behaviour, limitations
docs/BITBUCKET.md, docs/AZURE.md, docs/GERRIT.mdForge setup, submit behaviour, limitations
skills/tuicr/SKILL.mdThe agent skill and its split-pane wrappers

Sponsors

Thanks to the folks below for keeping tuicr development going, it means a lot to have the work I'm doing here appreciated!

CodeRabbit

License

MIT licensed. Contribution notes in CONTRIBUTING.md.

// faq

What is tuicr?

a code review TUI with vim keybindings. It is open-source on GitHub.

Is tuicr free to use?

tuicr is open-source under the MIT license, so it is free to use.

What category does tuicr belong to?

tuicr is listed under uncategorized in the Claudeers registry of Claude-compatible tools.

0 views
★ 3,644 stars
unclaimed
updated about 9 hours ago

// embed badge

tuicr on Claudeers
[![Claudeers](https://claudeers.com/api/badge/tuicr.svg)](https://claudeers.com/tuicr)

// retro hit counter

tuicr hit counter
[![Hits](https://claudeers.com/api/counter/tuicr.svg)](https://claudeers.com/tuicr)

// reviews

// guestbook

0/500

// related in Uncategorized / Others

🔓

Reverse engineer anything with agents, from app behavior down to native binaries.

// uncategorizedmorluto/⟨TypeScript⟩★ 468,336◷ MIT[ claude ]
🔓

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

// uncategorizedn8n-io/⟨TypeScript⟩★ 211,436◷ NOASSERTION[ claude ]
🔓

The agent engineering platform.

// uncategorizedlangchain-ai/⟨Python⟩★ 149,929◷ MIT[ claude ]
🔓

100+ AI Agent & RAG apps you can actually run — clone, customize, ship.

// uncategorizedShubhamsaboo/⟨Python⟩★ 144,747◷ Apache-2.0[ claude ]
→ see how tuicr connects across the ecosystem