5分钟上手Crit：从安装到第一次代码审查的Quickstart完整教程-平芜编程栈

【免费下载链接】crit

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

项目地址：https://gitcode.com/gh_mirrors/crit/crit

Crit 是一个本地优先（local-first）的 AI 代码审查工具：在浏览器中审查 AI coding agent 写出的计划（plan）、代码 diff 和正在运行的应用。点击某一行、留下评论，agent 就能直接收到你的反馈。单文件二进制、零遥测、默认只绑定本机回环地址，5 分钟就能跑通"安装 → 集成 → 第一次代码审查"的完整闭环。

什么是 Crit：给 AI 编码助手加一个"浏览器审查台" 🎯

对 agent 来说，计划和代码都只是文本；但对你来说，审一份方案和审一个跑起来的网页是两回事。Crit 为每类输出提供专属的审查 UI：

crit plan.md—— 渲染 Markdown 计划文件，可直接逐行评论
crit—— 自动检测 git 变更，以语法高亮的 diff 展示
crit http://localhost:3000—— 代理你的开发服务器，在真实页面上"钉"评论
crit landing.html—— 渲染静态 HTML 文件，边点边评

整个审查流程在本地完成，审查数据存放在~/.crit/reviews/，不会进你的仓库。

第一步：一键安装 Crit（支持 Brew / Go / Nix / Windows）📦

任选一种方式安装：

# Homebrew（macOS / Linux） brew install crit # Go go install github.com/tomasz-tomczyk/crit/cmd/crit@latest # Nix nix profile install github:tomasz-tomczyk/crit

Windows 用户可从 Releases 下载crit-windows-amd64.exe（ARM64 换成arm64）并放入PATH；WSL 直接装 Linux 版即可。也可以克隆源码自己编译：

git clone https://gitcode.com/gh_mirrors/crit/crit cd crit go build -o crit ./cmd/crit

装好后验证一下版本：

crit --version

第二步：接入你的 AI 编码工具 🔌

Crit 兼容几乎所有主流 agent：Claude Code、Cursor、GitHub Copilot、Codex、OpenCode、Windsurf、Cline、Gemini、Qwen、Grok、Aider 等——任何"能读文件、能跑命令"的工具都行。一条命令完成集成：

crit install claude-code # 为当前项目安装（可换成 cursor、codex、cline…） crit install all # 一次装齐所有支持的工具

这条命令会把审查工作流（/crit技能）写入对应工具的 skills 目录，可以安全重复执行。项目级安装的细节和各类工具的目标路径见 integrations/README.md，实现源码在 cmd/crit/cli_install.go。

安装完成后，在你的 agent 聊天里输入/crit（Codex 用$crit），它会自动执行"启动 Crit → 等待你审查 → 读取评论并修改 → 再开一轮"的循环，直到你批准为止。

第三步：跑通你的第一次代码审查 ✍️

在终端执行crit（或在 agent 中运行/crit），浏览器会自动打开审查页：

crit # 自动检测仓库里 git 改动的文件 crit plan.md # 只审查指定的计划文件 crit plan.md api-spec.md # 一次审查多个文件 crit http://localhost:3000 # 审查正在运行的开发服务器

核心操作就三个动作：

点击行号发表评论，或拖动选择一段行批量评论，体验与 GitHub PR 审查一致
agent 修改后，Crit 会在头部展示"上一轮 vs 这一轮"的增量 diff，支持Split / Unified两种视图切换
点Finish Review结束本轮；若无未解决评论则点Approve批准

审查会话管理命令速查 🧰

命令	作用
`crit status`	查看审查文件路径与守护进程状态
`crit resume`	挑选历史审查重新打开（支持从任意目录恢复）
`crit stats`	查看累计审查统计
`crit cleanup`	清理过期的审查文件

另外几个贴心设计：每个分支的审查文件互相隔离、草稿自动保存（关浏览器也能续）、支持 Vim 键位（j/k导航、c评论）、可同时开多个审查实例各占独立端口。

进阶速览：Story 模式与 Live 模式 🚀

Story 模式：审查大分支 / PR / MR 时，crit story会用 LLM 生成带"序章 + 章节"的 diff 叙事概览，先理解变更全貌再逐行细读。详见 docs/story-mode.md。
Live 模式：crit live <url>把跑起来的应用代理进审查 UI，直接在页面 DOM 上钉评论；遇到登录态问题可用--cookie/--cookie-file/--cdp-url透传 Cookie。完整排障清单见 docs/live-mode.md。

配置文件与目录速查表 🗂️

位置	作用
`~/.crit.config.json`	全局配置（对所有项目生效）
`.crit.config.json`	项目级配置，覆盖全局
`~/.crit/reviews/`	审查数据（按会话存放，不进仓库）

用crit config --generate > ~/.crit.config.json可以一键生成带注释的起始配置；crit config查看当前合并后的生效配置。常用配置项如port、base_branch、agent_cmd（启用"Send to agent"实时回复）等说明见 README.md 的 Configuration 章节。