GitWarren

GitWarren

在你自己的机器上审查自己的 git 仓库。 用你自己的机器、自己的 Agent，不经过别人的服务，也无需账号。

专为这样的时刻打造：编码 Agent——Claude Code、Codex 或任何其他会编辑磁盘文件的工具——刚刚完成工作，而改动尚未提交，仍留在工作树中。你可以在这里、在自己的机器上查看差异，在它成为提交之前先审查一遍。

gitwarren.com 提供 macOS、Windows 和 Linux 版本的下载。

---

功能

告诉 GitWarren 你关注哪些本地 git 仓库，然后针对这些仓库打开审查——审查会比较两个引用，并以拉取请求的形式呈现，包含对话、提交和文件更改选项卡，以及一个用于查看未受改动影响代码的浏览文件选项卡。

• 在工作成为提交之前进行审查。 如果正在审查的分支已在某个工作树中检出，GitWarren 会找到该工作树——无论它位于何处——并将其中已暂存、未暂存和未跟踪的改动纳入差异。这正是审查最有用的时机，也是让这个工具值得拥有的关键所在。
• 不仅能审查代码，也能审查文字。 差异可以用统一视图或并排视图阅读，并突出显示变更行中的改动词句。Markdown 文件可以渲染后阅读，编辑内容会像修订痕迹一样标出，也可以逐段添加评论。
• 不缓存任何内容。 屏幕上的每个分支名称、提交和差异，都会在显示时从 git 读取。
• 内容不会离开你的机器。 审查记录存放在应用数据目录中的一个 SQLite 文件里。无需账号，也不收集遥测数据；桌面应用唯一的对外请求是检查更新。
• Agent 是一等公民。 本地 AI Agent 可通过 stdio 上的 MCP 服务使用相同的功能——打开审查、读取评论、在讨论串中回复，并解决已修复的问题。
• 桌面应用或浏览器。 它可以作为 Electron 应用运行于 macOS、Windows 和 Linux，也可以通过命令将相同的审查界面提供给浏览器标签页。两种方式使用相同的渲染器，唯一的区别在于外壳。
• 也能审查其他机器上的代码。 没有屏幕的机器——VPS、WSL 发行版，或 Agent 工作的设备——可以运行无头部分，并通过 SSH、wsl.exe 或你自己的 tailnet 从其他位置进行审查；其仓库会和本机仓库一起列在同一个主页上。审查记录保存在代码所在的机器上，并始终留在那里；不会复制或中转到你已拥有的计算机之外的任何地方。

评论可以像拉取请求一样直接添加到代码行上。编写代码的 Agent 会在同一讨论串中回复，让你在阅读差异的同时就能获得答复：

---

安装

桌面应用

从 gitwarren.com 下载；如果使用 macOS，也可以运行：

brew install --cask klarluft/tap/gitwarren

命令行

在浏览器中提供与 Electron 窗口相同的评审界面，适用于未安装该应用的机器，或完全没有屏幕的机器：

brew install klarluft/tap/gitwarren-cli               # macOS and Linux, brings its own Node
curl -fsSL https://gitwarren.com/install.sh | sh      # macOS and Linux, no Homebrew needed
npx gitwarren serve                                   # anywhere Node 22.14+ is, including Windows

然后运行 gitwarren serve --open。参见 GitWarren 命令行。

在编码 Agent 中使用

如果你是从编码 Agent 进入的，请从这里开始。该插件会安装 MCP 服务，并提供一份说明，教 Agent 何时打开评审，以及如何回复你的评论：

/plugin marketplace add klarluft/gitwarren-app       # Claude Code, then:
/plugin install gitwarren@gitwarren
gemini extensions install https://github.com/klarluft/gitwarren-app
npx skills add klarluft/gitwarren-app                 # the note alone, for any agent

Cursor、Codex、VS Code 和 Kiro 都可以通过各自的插件界面读取同一个仓库。参见将其安装为插件。

---

文档

指南	内容
评审	评审是什么、如何发现未提交的工作、如何阅读和浏览大型差异、并排显示和自动换行、Markdown 预览、浏览和搜索仓库、标记已评审的文件、在编辑器中打开文件、键盘快捷键
Agent 访问（MCP）	MCP 工具、安装插件、Agent 如何将你引回应用、评论串、图片
GitWarren 命令行	serve、service install、安装 CLI 的四种方式、更新和移除
你的其他机器	通过 SSH、从 Windows 使用 wsl.exe、在 tailnet 上以及从手机访问仓库
架构	技术栈、两个界面共同调用的服务层，以及哪些内容会或不会被存储
开发	从源代码运行、项目布局、数据库迁移
发布	创建版本、自动更新、代码签名和公证
Glama 构建规范	Glama 管理页面实际读取的字段，以及这些字段含义的由来
已知限制	GitWarren 不支持的功能及其原因
GitWarren 跨主机使用	远程主机模型背后的设计方案

在用户机器上设置 GitWarren 的 Agent 应阅读 llms-install.md。

---

贡献

欢迎贡献。除了错误修复之外，较大的改动都应先在 Ideas 中展开讨论，以便在你投入时间之前先确定方案；方案确定后，就会转为一个 issue。请参阅 CONTRIBUTING.md，了解开发工作流、改动必须遵守的两项设计约束，以及一份优秀的拉取请求应具备哪些特点。

首次贡献合并前，你需要签署 贡献者许可协议。机器人会在你的拉取请求上处理此事；整个过程大约需要十秒，而且只需进行一次。CLA 将代码库中的版权集中管理，因此 GitWarren 可以在 GPL 之外提供商业许可，也可以在日后更改许可证，而无需逐一联系所有曾经的贡献者。你仍拥有自己作品的完整所有权，并可以随意在其他地方使用。

---

支持与隐私

如有疑问、想法或值得借鉴的配置，请前往 讨论区 — 遇到问题，请查看 问答； 有功能建议，请前往 想法； 如果有值得他人借鉴的 Agent 或远程计算机配置，请前往 展示与分享。 对于可以描述清楚的问题——GitWarren 做了什么，以及问题何时发生——请提交到 issues。如果有任何内容 不便公开发布，请发送邮件至 [email protected]。

GitWarren 会将所有内容保存在你的计算机上：评审内容存储在应用程序数据目录中的一个 SQLite 文件里，差异从你的 git 工作树读取，而且 无需账号，也不进行遥测。桌面应用唯一的外发请求是向此仓库的 GitHub Releases 查询自动更新。网站 隐私政策适用于 gitwarren.com 本身。

---

许可证

GitWarren 是免费软件，采用 GNU 通用公共许可证第 3 版或（由你选择）任何更高版本授权。完整文本见 LICENSE。

简而言之：你可以使用、研究、修改和再分发它，包括用于商业用途。如果你分发修改后的版本，或分发包含本软件的程序，也必须根据 GPL 发布该软件，并提供源代码。这种互惠正是 GPL 的宗旨——它让 GitWarren 及其衍生作品保持开放。

版权归 Klarluft B.V.（荷兰鹿特丹 · KVK 86875590）所有，所有贡献均受 CLA 约束。由于版权集中在一处，而非由各位贡献者共同持有，因此可以应要求授予 GPL 以外的许可证——例如，将 GitWarren 嵌入闭源产品时：请发送邮件至 [email protected]。

Michal Wrzosek（[email protected]）是 GitWarren 的创作者，目前也是其主要维护者。

Copyright © 2026 Klarluft B.V.

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see <https://www.gnu.org/licenses/>.