# GitBot

GitBot 是本地运行的开源编排中心，可将 Claude Code、Codex 或 OpenCode 封装为可复用机器人，提供持久会话和逐机器人权限配置。它在现有编程智能体之上增加浏览器工作台和可重复使用的角色，无需更换原有工具。

Canonical URL: https://aiidelist.com/zh/ide/gitbot

Language: zh

更新日期: 2026-10-06

## 概览

- 分类: Developer Workflow Tools
- GitBot 是本地优先的编排层，可将现有编程智能体 CLI 变为带权限的可复用机器人，通过浏览器工作台在不同仓库间使用。
- 编辑器基础: Standalone
- 平台: macOS, Linux, Windows
- 开源: 是
- 本地模型支持: 是
- 自带 API 密钥: 是

## 简评

GitBot 最适合已有偏好智能体、希望将重复指令转化为可在本地运行的复用角色的开发者。在网络认证和管理功能更成熟之前，它还不太适合作为团队共享服务。

## 适合场景

- 已使用 Claude Code、Codex 或 OpenCode，希望复用智能体角色的开发者
- 代码审查、文档检查、测试、维护和发布准备等重复仓库工作
- 希望持久保存智能体会话，又不想将仓库迁入托管 IDE 的本地优先用户
- 探索可迁移机器人指令与权限边界的团队或个人

## 优点

- 沿用 Claude Code、Codex 和 OpenCode 的现有登录
- 可复用机器人定义，减少跨仓库重复配置提示词
- 本地存储，无需使用 GitBot 托管的对话数据库
- 可逐机器人更换智能体，不把流程绑定在一家服务商上

## 局限

- 寻找全能 AI 原生代码编辑器的用户
- 需要 SSO、身份验证或集中管理的托管多用户服务的团队
- 希望直接包含编程模型、不愿另装和认证智能体的用户
- 需要将 GitBot 端口直接暴露在不可信网络的环境
- 本地服务器没有身份验证，不应公开到互联网
- Codex 不支持 GitBot 的逐工具审批及工具允许／禁止限制
- 它属于编排层，需先安装底层编程智能体并完成身份验证
- 项目仍处于早期 0.x 版本，行为与接口可能快速变化

## 为什么选择 GitBot？

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

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

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

## 核心工作流程

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

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

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

```bash
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 后，仓库不必转换格式；但如果没有单独共享或保存机器人定义，已保存的工作流层会丢失。

## 功能

### Agent 编排

- 用固定指令创建可复用机器人
- 逐机器人选择 Claude Code、Codex 或 OpenCode
- 保留关联指定目录的持久会话

### 控制与权限

- 选择只读、需审批或更宽松的权限模式
- 在浏览器审批 Claude Code 和 OpenCode 的工具请求
- 为支持的智能体配置工具允许／禁止列表

### 本地工作流

- 在自己的电脑上运行浏览器工作台
- 默认将机器人和会话记录保存在本地
- 共享机器人定义，或从 Library 安装社区机器人

## 安装

````````sh
npm install -g @gitbot-hq/gitbot
````````

## 价格

open-source

- Open Source: $0 — GitBot 软件采用 MIT 许可。订阅、API 或模型使用费由所连接的编程智能体或服务商收取。

价格核对日期: 2026-10-05

## 隐私与数据处理

GitBot 表示不设账号、不收集遥测，也不使用托管数据库，默认将机器人和会话记录存储在 ~/.gitbot。所选智能体仍可能将提示词和代码发送到配置的模型服务商。GitBot 本地服务器目前没有身份验证，并监听网络接口，因此只应在可信网络中使用，不应公开。

## 替代工具

- Claude Squad
- Agent Deck
- cmux

## 资料来源

- [官方网站](https://github.com/gitbot-hq/GitBot)
- [官方文档](https://github.com/gitbot-hq/GitBot#readme)
- [安装](https://www.npmjs.com/package/@gitbot-hq/gitbot)
- [下载](https://github.com/gitbot-hq/GitBot)
- [GitBot GitHub 仓库](https://github.com/gitbot-hq/GitBot)
- [GitBot npm 包](https://www.npmjs.com/package/@gitbot-hq/gitbot)
- [GitBot Library](https://gitbot.codeongrass.com/)
- [GitBot 架构说明](https://github.com/gitbot-hq/GitBot/blob/main/docs/ARCHITECTURE.md)

最近核对日期: 2026-10-05