Overview
tuicr (pronounced "tweaker") is a powerful and intuitive terminal-based code review tool designed for developers who love Vim. It brings a GitHub-style continuous diff experience directly to your terminal, allowing you to navigate, comment on, and submit code reviews with unparalleled efficiency. Built for speed and flexibility, tuicr supports Git, JJ, and Mercurial, and seamlessly integrates with GitHub and GitLab for direct review submission.
Key Features
- Vim-Powered TUI: Enjoy a rich, interactive code review experience within your terminal, complete with familiar Vim keybindings for effortless navigation and editing.
- Continuous Diff View: Scroll through every changed file in a single, unified stream, mimicking the flow of a typical code review.
- Flexible Commenting: Add inline comments at the line, range, or file level, as well as review-level summaries.
- Integrated Submission: Export your completed reviews directly to GitHub or GitLab with a single command.
- Agent-Ready Markdown: Generate structured markdown reviews for easy integration with AI coding assistants like Claude, Codex, or Cursor.
- Broad VCS Support: Works seamlessly with Git, JJ, and Mercurial, handling uncommitted changes, commit ranges, and remote PRs/MRs.
- Persistent Review Sessions: Track your review progress across sessions, with saved states for ongoing work.
- Extensive Customization: Personalize your experience with a wide array of themes, configurable keybindings, and fine-grained settings.
- Multiple Install Options: Easily install via script, Homebrew, Cargo, Mise, Nix, or by downloading pre-built binaries.
Typical Use Cases
- Efficient Code Reviews: Conduct thorough code reviews directly within your terminal, eliminating the need to switch contexts to a web browser for most tasks.
- Streamlined Developer Workflow: Quickly iterate on feedback, add comments, and submit changes without leaving your coding environment.
- AI-Assisted Development: Generate structured review summaries that can be easily passed to AI coding agents for analysis and code generation.
- Cross-Platform Collaboration: Whether using Git, JJ, or Mercurial, tuicr provides a consistent and powerful review experience.
- Remote PR/MR Management: Review and comment on GitHub Pull Requests and GitLab Merge Requests directly from your terminal.
