tuicr Skill:终端代码审查神器,用 vim keybindings 在 TUI 里搞定 GitHub PR

tuicr 是一个运行在终端的代码审查工具,以 vim keybindings 为核心交互方式,支持将审查结果直接导出到 GitHub PR、GitLab MR 或剪贴板。项目发布于 2026 年 1 月,当前处于 GitHub Trending 榜单前列(今日 338 stars),受到 Rust 开发者社区的广泛关注。它解决了代码审查流程中”在终端里就能完成一切”的需求——不需要切换到浏览器页面,也不需要安装重型 IDE,直接在终端里逐文件、逐行地查看 diff、写评论、提交审查意见。

功能与原则

核心功能基于 GitHub 风格的连续 diff 显示,提供 PR 级别的行级、文件级、审查级评论。项目支持与 git、jj、mercurial 三种版本控制系统集成,可以审查未提交变更、commit 范围,或直接拉取 GitHub PR / GitLab MR。审查会话结果可跨 session 持久化保存,工具会自动追踪已审查的 commit,防止重复劳动。

设计原则是”Everything in terminal”——所有操作无需离开终端,并提供三种导出路径:向 GitHub / GitLab 推送真实评论、向剪贴板复制结构化 Markdown,或通过 stdout 管道传给其他 agent(Claude、Codex、Cursor 等)。

认可度

  • GitHub stars:1,719(截至 2026-07-30),forks 153
  • 今日新增 338 stars,持续稳定在 Trending 榜单
  • crates.io 持续有新版本发布,活跃度高
  • 内置 Claude Code / Cursor 等 AI 编程工具的集成路径,契合当下 AI Coding Agent 生态

链接

GitHub:https://github.com/agavra/tuicr

原作者

agavra(GitHub: @agavra)— 独立开发者,专注于 Rust 语言工具链与开发者体验改善。

介绍

tuicr 发音为 “tweaker”,定位是代码审查的”终端版 GitHub PR 界面”。当你运行 tuicr 后,它会在终端渲染出一个类似 GitHub PR 界面的连续 diff 视图,用 j/k 上下导航,用 c 添加评论,用 y 复制结果或 :submit 提交到 GitHub/GitLab。

内置的评论追踪机制会记住你审查了哪些 commit——当你重新打开同一个 PR 时,tuicr 会自动跳过已审查的 commit,并用 ✓ 标记出来。这个设计对大型 PR 和需要分多次审查的场景特别有用。

tuicr 还提供了丰富的定制能力:支持 20+ 主题(包括 catppuccin、nord、gruvbox 等流行主题),支持 side-by-side 或 unified 两种 diff 视图,支持鼠标操作、可配置的 leader 键,以及多种评论类型(issue、nit、suggestion 等,每种可自定义颜色和定义)。

特点

  • 纯终端代码审查:不需要浏览器或 IDE,在终端完成全部审查流程
  • vim 键位导航:j/k 滚动、c 添加评论、y 复制、:submit 提交,符合开发者肌肉记忆
  • 会话持久化:审查进度自动保存,跨 session 追踪已审查的 commit,避免重复审查
  • 多平台导出:支持 GitHub PR、GitLab MR、剪贴板 Markdown 和 stdout 管道,兼容 AI Agent 工作流
  • Agent-ready:内置 tuicr SKILL.md,可作为 Claude Code、Cursor 等 agent 的代码审查 skill 使用
  • 支持 jj/mercurial:不仅是 git,还支持 jj(GitHub 内部也在用的版本控制)和 mercurial

使用方法

安装:

# 一键安装(Linux/macOS)
curl -fsSL tuicr.dev/install.sh | sh

# 或通过 Homebrew
brew install agavra/tap/tuicr

# 或通过 cargo
cargo install tuicr

基本使用:

tuicr                    # 从 commit 选择器开始
tuicr -w                 # 直接审查未提交的变更
tuicr -r main..HEAD     # 审查 main 到 HEAD 的 commit 范围
tuicr pr 125            # 直接拉取 GitHub PR #125
tuicr mr 125            # 直接拉取 GitLab MR #125
tuicr --stdout          # 将审查结果输出到 stdout(管道给 agent)

内置命令(在 TUI 内):

  • j/k:上下滚动
  • c:添加评论
  • y:复制审查结果到剪贴板
  • :submit:推送到 GitHub / GitLab
  • :quit:退出

作为 Claude Code skill 使用:

在 tmux 或 Zellij 分屏中,一边打开 tuicr 审查代码,一边让 Claude 分析评论内容并给出修复建议,形成”人工审查 + AI 辅助”的高效闭环。

使用场景与人群

适用场景:
– 不想切换到浏览器进行代码审查的开发者
– 需要在服务器端远程审查代码(无 GUI 环境)
– 分多次审查大型 PR,需要记录审查进度
– 与 AI coding agent 配合做代码质量把关

目标用户:
– 后端 / DevOps 工程师(经常在服务器环境工作)
– vim/终端深度用户(喜欢全键盘操作)
– 使用 Claude Code、Cursor、Codex 等 AI 编程工具的开发者
– 团队需要统一代码审查流程但希望减少浏览器依赖

输入与输出案例

案例 1:审查本地未提交变更

tuicr -w

输出:终端渲染连续 diff 视图,逐文件、逐 hunk 显示变更,j/k 导航,c 添加评论,写完后 y 复制结构化 Markdown:

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

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

案例 2:将审查结果推送到 GitHub PR

tuicr pr 125
# 在 TUI 中完成所有评论后,输入 :submit
# 选择 Comment / Approve / Request changes

结果:真实 GitHub PR Review,内联评论直接出现在 PR 页面的对应行号旁,审查摘要成为 PR 评论区的第一条评论。


GitHub: https://github.com/agavra/tuicr

评论区

0 条评论

登录后可评论。

Skill超级捕获手 13 阅读