tomasz-tomczyk/crit

Review AI coding agents' plans, diffs and running apps in the browser. Local-first, works with any agent.

Crit – 面向 AI 辅助编码的交互式审查 UI

它是什么 – 一个单一二进制、本地运行的应用，让您（以及任何 LLM 驱动的编码代理）在浏览器中审查计划、差异或实时 Web 应用。您可以点击任何行，添加内联评论，代理可以读取这些评论、编辑代码并实时回复。

为什么重要 – 虽然许多 AI 代码工具生成代码，但 Crit 专注于反馈循环：一个 UI，为任何文本输出（markdown 计划、git 差异、静态 HTML 或运行中的开发服务器）镜像 GitHub 风格的审查。它弥合了 LLM 的文本输出与人类逐行审查之间的差距，使编辑-审查-重复循环更快、更直观。

快速开始

安装 – brew install crit（或 go install、Nix，或从发布页面下载二进制文件）。
连接代理 – 将 Crit 插件添加到 Claude Code（claude plugin marketplace add tomasz-tomczyk/crit）或使用任何支持的代理（Cursor、GitHub Copilot、Aider、Gemini 等）。
运行 – 在仓库内的终端中，直接运行 crit。它会自动检测更改的文件并打开本地 Web UI。您也可以指定特定文件（crit plan.md）、运行中的服务器（crit http://localhost:3000）或静态 HTML 页面。

核心功能

自适应 UI – 针对 markdown 计划、git 差异、实时 Web 应用和静态 HTML 的不同渲染器。
逐轮差异 – 代理编辑文件后，Crit 显示更改的分屏或统一差异。
内联评论 – 点击一行或拖动一个范围来添加评论，就像 GitHub PR 审查一样。
程序化评论 – 代理可以通过 crit comment … 添加评论，无需打开浏览器。
故事模式 – 为大型 PR/分支生成高层级、分章节的概览，以提供逐行审查前的上下文（LLM 驱动，成本感知）。
实时模式 – 代理运行中的开发服务器，注入审查覆盖层，并可转发会话 cookie，以便认证应用正常工作。
共享 – 一键将审查上传到公共 URL（crit.md 或自托管目标）以进行异步协作。
GitHub / GitLab 同步 – 拉取和推送评论到 PR/MR，完全支持批准和请求更改。
发送到代理 – 点击评论上的“立即发送”，让配置的 LLM（例如 Claude Code）响应并可选地自动编辑代码。
按分支隔离 – 审查数据存储在 ~/.crit/reviews/ 中，并限定于当前 git 分支。
零遥测 – 没有隐藏的分析；唯一的网络调用是可选的版本检查。

典型工作流程

代理编写计划或代码更改。
您调用 /crit（或本地运行 crit）。UI 打开显示计划、差异或实时应用。
您点击行、添加评论，或使用“发送到代理”按钮。
代理读取评论，如果允许则编辑文件，并回复。
重复直到审查通过，然后可选地 crit push 将评论同步回 PR/MR。

集成点

Claude Code、Cursor、GitHub Copilot、OpenCode、Aider 等 – 都可以通过斜杠命令或运行二进制文件来调用 Crit。
仅 CLI – crit comment、crit share、crit pull、crit push、crit live、crit status、crit resume、crit stats、crit cleanup。
配置 – 全局（~/.crit.config.json）和项目（.crit/config.json）JSON 文件控制实时模式 cookie、共享目标、默认 forge 以及用于“发送到代理”的 agent_cmd。

适用人群

已经使用 LLM 编码助手并希望获得更丰富、可视化审查循环的开发者。
需要在合并前审查 AI 生成的计划或代码的团队。
喜欢 GitHub 风格评论体验但不想离开本地机器的独立工程师。

限制 / 注意事项

所有代码和审查数据都保留在本地，除非您明确共享。
“发送到代理”要求您信任配置的 agent_cmd；只有全局配置可以设置它，以避免恶意仓库级执行。
实时模式可能需要额外的 cookie 处理，以支持带认证的应用。

资源

演示视频 – https://www.youtube.com/watch?v=LHwfdvePf5A
文档 – docs/story-mode.md、docs/live-mode.md、docs/renderers.md
源代码 – https://github.com/tomasz-tomczyk/crit

底线 – Crit 是一个实用的、本地运行的 UI，将任何 LLM 生成的文本（计划、差异或运行中的应用）转化为交互式审查界面，让人类和代理快速迭代，同时将所有内容置于开发者的控制之下。