GitBot

为什么选择 GitBot？

GitBot 解决的问题与 AI 代码编辑器或独立编程智能体不同。底层智能仍来自 Claude Code、Codex 或 OpenCode，GitBot 在它们之上提供持久的任务组织与操作层。

当同样的指令在不同仓库间反复使用时，这种设计就有价值。例如，开发者可能经常让智能体审查分支、检查文档、寻找测试缺口、准备发布说明或解释陌生代码库。普通 CLI 会话往往需要重复定义角色；GitBot 则将这些固定工作变成有名称、长期指令和明确权限的机器人。

实际优势是一致性。每个会话使用的仓库可以不同，但角色保持稳定。因此 GitBot 更接近可复用的智能体工作流系统，而不仅是另一个聊天界面。

核心工作流程

GitBot 在浏览器与电脑上已安装的智能体 CLI 之间运行本地服务器。机器人定义固定工作、执行智能体、权限模式，以及可选的一次性初始化指令；会话再将该机器人与具体目录和对话历史关联起来。

区分机器人和会话很重要。机器人是可复用的规则，会话是实际工作过程。同一个审查机器人因此能在多个仓库中工作，无需每次新建对话都复制很长的系统提示词。

典型的本地启动方式如下：

npm install -g @gitbot-hq/gitbot
cd /path/to/your/projects
gitbot start

随后可在浏览器界面管理任务，所选智能体仍在本地执行。因此，无需将仓库迁入云 IDE，也无需学习新的编辑器。

适用场景

GitBot 更适合重复性工作，例如仓库审查、代码库导览、文档检查、测试缺口查找、日常维护及发布准备，而非一次性提示。

开发者想比较不同智能体后端、又不想为每个重新设计流程时，它也有帮助。定义一次可复用工作后，就能分配给可用智能体。不同智能体的权限和沙箱模型仍有差异，行为不会完全一致，但外围流程需要改动的地方更少。

公开的 GitBot Library 进一步扩展了这一思路。安装前可查看机器人定义，共享内容不包含原始聊天历史或本地项目文件。因此，可复用的单位更像可迁移的智能体角色，而非一份共享聊天记录。

同类工具对比

如果主要需求是并行运行多个编程智能体任务，Claude Squad 更贴近。它以终端为主，强调隔离工作区和应用修改前的审查。GitBot 则围绕角色，将重复工作封装为机器人，再为它提供浏览器内的持久会话。

Agent Deck 也面向管理大量本地智能体会话的开发者，但重点是用于管理会话、worktree、状态和智能体群的控制台。GitBot 则更容易理解为一组可重复执行的工作，只是可选择不同智能体后端运行。

cmux 类智能体管理工具更注重并行执行、工作区隔离和任务监督。当可复用指令本身就是资产，例如要求在不同仓库中保持一致的审查员、测试编写者或发布助手时，GitBot 更贴合需求。

因此 Cursor、Windsurf 等 AI 原生编辑器不是直接替代品。它们提供编辑环境，而 GitBot 位于智能体 CLI 之上，可与现有编辑器并用。

配置建议

最重要的配置不是模型，而是权限边界。使用不熟悉的机器人或仓库时，应从足以完成任务的最严格权限开始。审查员和代码讲解任务适合只读模式；需要修改的流程通常应先开启审批，而不是广泛自动执行。

智能体选择也会改变安全模型。Claude Code 和 OpenCode 可通过 GitBot 展示工具审批请求，并使用工具允许／禁止列表。Codex 的集成方式不同：GitBot 依赖其沙箱模式，而非逐操作审批，也无法对 Codex 执行相同的工具列表限制。

网络暴露同样需要注意。可从同一可信网络的其他设备方便地访问浏览器界面，但服务器目前没有身份验证。应将 GitBot 端口视为能访问强大智能体的本地开发服务，不要通过公开反向代理发布，也不要直接暴露到互联网。

使用本地模型或自选服务商时，GitBot 本身不提供推理引擎或凭证存储。这些能力由所选编程智能体间接提供，尤其是配置了自定义或本地服务商的 OpenCode。因此，模型连接、凭证及兼容性仍由底层智能体负责。

迁移建议

从直接使用 Claude Code、Codex 或 OpenCode 迁入的成本较低，因为 GitBot 不替换这些工具。已有安装和身份验证仍是基础，GitBot 只在外围增加可复用定义与持久会话记录。

主要迁移工作是判断哪些提示词值得长期做成机器人。适合转换的工作应具有稳定角色、可重复约束和明确完成标准。一次性调试通常继续使用普通智能体会话更好。

共享机器人也不同于导出整个工作区。共享定义仅包含可复用指令和设置，不含本地文件或聊天历史，因此能在统一流程的同时，不自动分发仓库上下文。

仓库几乎不会被锁定：代码仍在普通本地目录中，底层智能体也能独立使用。需要注意的是 GitBot 自身的机器人与会话数据，默认保存在 ~/.gitbot。移除 GitBot 后，仓库不必转换格式；但如果没有单独共享或保存机器人定义，已保存的工作流层会丢失。