tomasz-tomczyk/crit

Your feedback loop with the agent

Crit 的功能

Crit 是一个本地的单二进制工具，能够让你 审阅 AI 代理产生的任何文本输出——计划、代码差异，甚至是运行中的 Web UI——并 直接在上面评论。这些评论会保存在本地，并可以发送回代理让它修复问题，形成快速的“审阅‑修正”循环。

核心工作流

  1. 运行工具 – crit 会自动检测 Git 仓库中改变的文件，或者你可以指定特定的 markdown 文件、HTML 页面，或实时的 Web 服务器（crit http://localhost:3000）。
  2. 审阅 UI – UI 显示文件并提供语法高亮、分割或统一差异，点击行号即可添加行内评论（单行或范围）。
  3. 将反馈发送给代理 – 当评论标记为“立即发送”时，Crit 会把评论、其上下文以及文件位置传给已配置的 AI 代理（Claude、Aider、Cursor 等）。代理的响应（或编辑后的文件）会被捕获并内嵌显示。
  4. 迭代 – 代理编辑文件，Crit 监控变化、更新差异，你重复此过程直至审阅通过。

亮点

  • 自适应 UI：支持 markdown、代码差异、静态 HTML 或实时 Web 应用（通过代理）。
  • 回合差异：每次代理编辑后都能精准看到变化。
  • 程序化评论：代理可以通过 crit comment … 添加评论，无需打开浏览器。
  • 分享审阅：生成公共 URL（或二维码），让他人查看或添加评论；也可通过 crit-web 自行托管。
  • GitHub PR 同步：将已有 PR 评论拉入 Crit 审阅，并将新评论推回 PR（需要 GitHub CLI）。
  • 分支隔离：每个 Git 分支都有独立的审阅文件，存放在 ~/.crit/reviews/ 下。
  • 实时模式：代理运行的开发服务器，转发 Cookie，实时审阅 UI。
  • 可配置：通过全局 (~/.crit.config.json) 与项目 (.crit.config.json) JSON 文件配置；许多标志也可用环境变量设置。

适用人群

  • 让 LLM（Claude、Cursor、Aider 等）编写代码或计划，并需要 人工在环 审阅步骤的开发者。
  • 想要轻量、本地化的 AI 生成变更审阅替代方案的团队。
  • 任何构建 AI 助手工作流，且希望拥有 可视化、评论驱动的反馈渠道，不必离开终端的人。

安装与快速开始

# Homebrew (macOS/Linux)
br ew install crit
# 或通过 Go、Nix、Windows 二进制，或直接下载

随后将你的代理集成进去（例如 claude plugin marketplace add tomasz-tomczyk/crit），在代理中调用 /crit 命令，或手动运行 crit。

一句话概括：Crit 是一个本地运行的审阅 UI，桥接人类反馈与 AI 代理，将纯文本输出转化为交互式、评论驱动的工作流。