GitBot icon

GitBot

GitBot 是基于本地浏览器的工作区,可借助 Claude Code、Codex 或 OpenCode 创建可复用的编程机器人,跨仓库文件夹运行代理,并保留持久线程与可配置权限。

GitBot

面向编程代理的本地编排

GitBot 是一个在本地运行的 Web 界面,用于创建和复用跨仓库文件夹的编程代理机器人。它将浏览器连接到同一台机器上安装的 Claude Code、Codex 或 OpenCode,为每个机器人指定工作、代理配置和权限设置。

机器人可以跨线程复用,而每个线程会将机器人连接到选定的文件夹,并保留底层代理会话以便后续工作。GitBot 会在本地存储机器人和线程记录,而不是作为托管服务运行;所选编程代理仍负责与其配置的提供商通信。

功能

可复用的编程机器人

创建可复用的机器人,配置固定指令、代理选择、受支持时的模型、权限设置、可选的允许工具列表以及可选的一次性设置步骤。

本地代理执行

在所选仓库文件夹中本地运行 Claude Code、Codex 或 OpenCode,使用机器上已有的代理安装和提供商配置。

持久线程

将工作组织为与机器人和文件夹关联的线程。GitBot 会恢复代理自身的会话,使对话能够在重新打开后继续。

可恢复的浏览器工作区

将代理输出流式传输到浏览器,并在浏览器断开连接时保持回合运行。返回后,GitBot 可以重新连接并重放已缓冲的事件。

权限控制

在 Claude Code 和 OpenCode 中使用审批提示,或为 Codex 选择只读、规划或在工作目录中编辑等模式。可以从线程的聊天栏更改权限设置。

机器人共享与 Marketplace 工作流

复制机器人的设置和指令供他人导入,或准备 Marketplace 列表和拉取请求以供审核,而不会自动发布。

使用场景

  • 仓库审查与维护

    定义固定的审查任务,例如检查文档是否与当前代码一致,然后在仓库中启动线程,让机器人在修改前检查具体问题。

  • 可重复的开发任务

    为重复性的编程任务使用不同的机器人,稍后返回其线程继续工作,并将工作与同一个仓库文件夹和代理会话关联。

  • 受控的代码库探索

    在探索不熟悉的代码库时,为代理设置只读或基于审批的工作流;只有在了解任务和仓库后,才使用更宽泛的权限。

  • 共享团队工作流

    复制机器人的指令和设置供他人导入,或准备可供检查并通过拉取请求提交的公开 Marketplace 贡献。

Pros and Cons

Pros

  • 无需 GitBot 账户、托管数据库或单独的云组件即可本地运行。
  • 支持可复用指令、持久代理会话、限定仓库范围的线程以及可选设置步骤。
  • 为 Claude Code 和 OpenCode 提供审批转发,并为 Codex 提供可选择的沙箱或权限模式。
  • 可以在本地机器上的浏览器中访问,也可以在受信任网络中的另一台设备上访问。
  • 可以复制机器人设置和指令以供导入,或准备经过审核的 Marketplace 提交。

Cons

  • GitBot 没有身份验证,因此任何能够访问其监听端口的人都可能使用这台机器的访问权限运行代理。
  • 所选编程代理以及 Node.js 18 或更高版本必须单独安装和配置。
  • Codex 不提供 GitBot 的逐操作审批通道,也不会强制执行允许工具列表,因此其所选沙箱模式是主要的权限边界。

FAQ

如何安装并启动 GitBot?

安装 Node.js 18 或更高版本,安装并登录至少一个受支持的编程代理 CLI,然后使用 npm install -g @gitbot-hq/gitbot 安装 GitBot。从包含项目的文件夹启动它,并在 http://localhost:3000 打开本地 Web 界面;或者在受信任的本地网络中使用显示的网络地址。

GitBot 支持哪些编程代理?

GitBot 支持 Claude Code、Codex 和 OpenCode。你可以使用代理已有的安装和登录状态;GitBot 不要求单独的 GitBot 账户。

机器人和线程有什么区别?

机器人用于存储可复用的指令、代理选择、适用时的模型、权限模式、可选的工具限制以及可选的设置指令。线程则将该机器人与仓库文件夹配对,并保留代理会话以便后续工作。

主要的安全注意事项是什么?

GitBot 没有身份验证,并且会监听所有网络接口。任何能够访问其端口的人都可能使用这台机器上运行的代理,因此应将其保留在受信任的网络中,不应暴露到公共互联网。

GitBot 的数据和对话存储在哪里?

机器人和线程记录默认存储在 ~/.gitbot 下,数据目录可通过 GITBOT_DATA_DIR 配置。GitBot 本身不托管代理、对话或云数据库;所选代理可能会将提示和代码发送给其配置的提供商。

Quick Facts

类别
开发者工具
部署方式
带浏览器界面的本地 Node.js 服务器
支持的代理
Claude Code、Codex 和 OpenCode
所需运行时
Node.js 18 或更高版本
本地数据位置
默认为 ~/.gitbot;可通过 GITBOT_DATA_DIR 配置
主要工作流
在选定的仓库文件夹中运行可复用的编程机器人