📌 项目地址agavra/tuicr | ⭐ 1,781 颗星 | 🔧 Rust | 📜 未标注

解决了什么问题

代码审查常常要在IDE、GitHub网页、终端之间来回切换。如果你习惯在终端里工作,并且依赖git、jj或mercurial,tuicr能让你在命令行中完成整个审阅流程:查看diff、添加行级或文件级注释、跟踪审查进度,最后一键推送到GitHub或GitLab,或者复制成结构化Markdown。

快速上手

安装后,直接用一条命令启动审查:

tuicr                       # 选择commit(交互式)
tuicr -w                    # 审查未提交的变更
tuicr -r main..HEAD         # 审查特定commit范围
tuicr pr 125                # 审查GitHub PR #125
tuicr mr 125                # 审查GitLab MR #125
tuicr --stdout              # 将审查结果输出到stdout

内部操作受vim键绑定支持,j/k上下移动,c添加注释,y复制审查结果,:submit直接推送。会自动检测当前仓库使用git、jj还是mercurial。

核心功能

  • GitHub风格连续diff:所有修改的文件在一个流中滚动查看,不用来回切换。
  • 多层级注释:支持行级、范围级、文件级、审阅级注释,类似在线PR体验。
  • 审查跟踪:已审查的文件或hunk会标记,跨会话持久化,下次打开可继续。
  • 导出灵活:可以推送到真实PR/MR,也可以复制到剪贴板或管道输出。
  • 版本控制兼容:支持git、jj、mercurial,覆盖主流现代VCS。

与同类工具对比

官方README提供了一个对比表(可访问 tuicr.dev 查看完整信息),列举了tuicr与其他终端审查工具(如hunk)的差异。tuicr的特色在于:合并了vim键绑定、多VCS支持、PR评论导出、以及持久化审查状态。

注意事项

  • 若从GitHub/GitLab拉取PR/MR,需要配置相应的访问令牌(参考官方文档)。
  • 使用tuicr update自动更新时,会检测包管理器(Homebrew、Cargo、Mise、Nix)并依据实际安装方式更新。手动下载的二进制文件会原地替换并校验SHA-256。
  • 当前版本(0.18.0+)暂未支持哪些后端?README未提及,实际使用时建议先检查release notes。

尝试一下

curl -fsSL tuicr.dev/install.sh | sh
# 或
brew install agavra/tap/tuicr

然后在你的项目目录中运行 tuicr -w,感受一下终端里的PR审查体验。

这篇文章对你有帮助吗?

发表回复