tuicr
a code review TUI with vim keybindings
tuicr is a terminal-based code review tool with vim keybindings that integrates with AI coding agents through structured markdown exports. It provides a GitHub-style continuous diff viewer where developers can add line, range, file, and review-level comments, then export those comments to GitHub, GitLab, Bitbucket, Azure DevOps, or as agent-ready markdown. The tool tracks review progress across sessions and works with git, jj, and mercurial repositories. Agents can consume tuicr's numbered comment output to understand and address code review feedback programmatically.
Key Features
Use Cases
- 01Conducting terminal-based code reviews and exporting feedback as structured markdown for AI coding agents to implement
- 02Reviewing GitHub pull requests, GitLab merge requests, or Bitbucket PRs directly from the command line
- 03Creating persistent review sessions that can be resumed across multiple sessions for large changesets
- 04Integrating code review workflows into agent-driven development where AI assistants open tuicr in terminal multiplexers
- 05Tracking review progress at file or hunk granularity across uncommitted changes or commit ranges
- 06Using the review CLI or Rust library API to programmatically add comments from scripts or tools
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
tuicr — FAQ
What is tuicr and how does it work with AI agents?+
tuicr is a terminal-based code review tool that exports structured markdown comments formatted for AI coding agents like Claude, Codex, and Cursor. Each comment includes a number and file/line anchor that agents can parse to understand and address review feedback programmatically.
How do I install tuicr?+
Install via the install script (curl -fsSL tuicr.dev/install.sh | sh), Homebrew (brew install tuicr), Cargo (cargo install tuicr), pacman on Arch (sudo pacman -S tuicr), or download pre-built binaries from GitHub releases. Update with tuicr update.
Which version control systems does tuicr support?+
tuicr auto-detects and works with git, jj (Jujutsu), and Mercurial (hg) repositories. It can review uncommitted changes, commit ranges, or remote pull requests from GitHub, GitLab, Bitbucket, and Azure DevOps.
Do I need API keys or authentication to use tuicr?+
Local diff reviews require no authentication. Submitting reviews to GitHub requires gh CLI authenticated to the repo, GitLab requires glab, Bitbucket requires bkt authenticated to bitbucket.org, and Azure DevOps requires AZURE_DEVOPS_EXT_PAT or az login.
Is tuicr free and open source?+
Yes, tuicr is MIT licensed and free to use. The source code is available on GitHub at agavra/tuicr.
Which AI coding agents can consume tuicr's markdown output?+
Any coding agent that can read structured markdown, including Claude, Codex, Cursor, and similar tools. Copy the review with 'y' or ':clip', or pipe it with --stdout to pass directly to an agent workflow.
How do I install tuicr?+
Open the source repository on GitHub and follow its README. tuicr is a skill — MCP Agents Market links you directly to the official repo.
Is tuicr free?+
tuicr is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.