Gitgo

Gitgo 是面向真实项目开发的终端 Agent harness，将模型、工具、Git 工作区和持久任务状态组织成可观察、可恢复的工作流程。你可以用自然语言调查项目、明确需求、修改文件、执行验证，并在同一项目中持续迭代。

模型负责理解、规划和发起操作；工具提供文件、搜索、命令等能力；运行时、授权与存储组件负责执行、权限和证据。正式界面使用 Bun、React 和 Ink，通过 Native Host 连接项目运行服务。

当前基线为 1.0.0-alpha.3，整合知识、提示词、工作台、原生沙箱基础设施、管理更新与历史缩放，以及后续状态协作和终端交互修复。Alpha 3 属于预览渠道，与稳定版分开；公开 Windows x64 包以 Alpha 3 Release 的发布资产和验证摘要为准。源码、冻结包与人工终端分别验收，不代表跨平台完整沙箱，见 Alpha 3 范围。

下载已发布版本 · 安装 · 配置 · 版本 · 贡献

Gitgo 提供哪些优势

以“模型调用、工具执行、会话历史”组成的基础 harness 为参照，Gitgo 在需求、授权、交付和恢复之间建立了可检查的联系。下表列出当前已实现的能力，以及支持这些能力的证据；具体产品之间的比较需要独立对照试验。

使用中的价值	已实现的机制	已有证据
用户回答真正影响后续任务	问题逐题展示；答案绑定任务和问题，更新依赖与完成条件；明确委托剩余选择后继续交付	问题依赖、改答失效和回答来源回归；真实 API 与正式终端验证
交付结果可以追溯	完成检查使用实际调用回执、测试记录和交付文件；无法满足的质量要求可明确选择部分交付或停止，保留缺失事实	完成门禁与文件证据回归；真实 API 文件交付验证
自定义工具沿用权限边界	组合工具逐叶校验权限，保存已完成前缀，批准后恢复；工具发明沿用调用链授权	逐叶暂停、冷恢复、过期续跑与重复执行回归；部分真实权限场景验证
中断与并发变化有明确处理	生命周期守卫、版本条件更新和事务事件；恢复时区分已提交事实与待核实的外部效果	过期写入拒绝、事务回滚、事件重放、取消及跨进程恢复回归
Provider 故障后保持任务连续	可配置备用顺序与熔断；路由绑定实际模型身份和能力，保持主配置	真实失败首位与备用 API 测试；连续会话、身份和搜索验证
终端选择与项目数据相互独立	检测并验证终端；设置变更在下次启动生效；同一项目和状态目录共享历史	正式 Git Bash 启动与交互验收；配置及持久化回归

普通任务由主模型直接理解和处理。依赖计算、回执校验、权限匹配和状态更新交给相应组件；仍有效的解释可复用。后台统计静默记录用量和运行事件，支持后续分析。

这些证据支持已覆盖的机制与行为。总体回答质量、长任务可靠性和单位任务成本的改善仍是待验证目标，将通过同模型、同任务的纯 API 与 Gitgo 对照逐步评估。模型已经具备的提问与规划能力也纳入对照。

对应测试入口与验收边界见测试结果。

当前实现

**项目操作：**文件读取、写入、编辑、追加；默认 ripgrep 搜索；命令执行、文档文本读取和联网检索，失败与能力回退有明确提示。
**任务协作：**主任务、子任务、依赖、独立 worktree、审查、取消和显式恢复。
**模型接入：**OpenAI Responses、Chat Completions、Anthropic Messages 风格协议；能力探测、自动 failover 与备用队列。
**交互：**流式消息、需求问题卡、权限审批、思考与正文区分、折叠、滚动、复制和粘贴。
**持久化与观察：**SQLite 与内容寻址存储保存状态和证据；持久事件支持消费恢复；后台用量统计与架构增长告警。

2026-10-11 Alpha 2 候选已有后端 1395 passed / 2 skipped、Dashboard 173 passed / 0 failed、类型检查及源码正式 Git Bash 人工验收记录。Alpha 2 ZIP 的冻结 Host/daemon/工具、历史连续性及真实 API 验收通过，解压包的正式终端主流程已由用户确认，扩展测试 Trace 另行核对；下载包的具体范围以其版本说明为准。

完整能力清单见当前功能，失败案例和平台边界见已知限制。

开始使用

从 Alpha 3 Release 下载 Windows x64 ZIP 和校验文件，核对后完整解压；按安装说明建立独立管理安装，再运行生成的 gitgo.ps1。
首次启动在 Terminal 行用左右方向键选择检测到的终端，按 Enter 保存。
打开 /config → Providers，填写协议、Base URL、模型和凭据。需要备用路由时开启自动 failover 并设置顺序。
选择项目，输入任务，例如“调查这个项目的启动流程，给出问题和证据”。模型需要澄清时回答问题卡；涉及受限操作时处理审批。
在同一项目继续对话。以后可在 /config → General 更改终端，下次启动使用新选择。

配置与凭据保存在本机；Windows 凭据按当前用户加密。项目历史使用对应状态目录，显式设置独立状态目录可隔离测试数据。

从源码运行时，先按开发要求准备 Python、Bun 和依赖，再在仓库根目录启动完整终端界面：

run_dashboard_native.bat

安装与退出 · 配置说明 · 终端与历史 · Provider 切换

接下来完善什么

方向	当前状态与目标
行为与效率对照	已有小样本 API 对照和后台采集；继续积累自然任务、边界与长任务数据，衡量收益和额外成本
信号与恢复	持久事件已接入核心路径；继续迁移旧回调与状态通道，验证组合行为
隐私与文档维护	现有规则覆盖部分凭据和私有内容；完整引用检查、公开候选审批与持续文档维护待实施
多人、多仓库 Git 流程	已有任务/worktree 能力和贡献规范；workspace、trial、formal 的跨仓库生命周期自动化待实施
平台、隔离与运行模式	macOS/Linux、完整 OS 沙箱及模式切换另行推进，以对应平台和交互验收为准
本地模型	实际本地模型接入验收延期，后续单独验证

功能和问题通过 Issues 跟踪。表中的计划分别验收，并随实现更新功能状态。

参与贡献

阅读当前功能、已知限制和相关 Issue，明确本次范围、依赖与验收目标。
从上游最新 master 创建功能分支；外部贡献者在自己的 fork 开发，再向主仓库 master 提交 PR。分支合入后的保留或清理单独确认。
按贡献指南使用提交格式，执行相关回归；行为变更补充真实 API 验证，界面变更在完整正式终端中验收。
使用 PR 模板写清变更、实际测试环境、兼容性、迁移和剩余风险。检查候选文件及其引用，移除凭据、私人数据和编程指引。

Dashboard 开发 · Windows 构建 · 测试与复测 · 安全报告 · 安全与隐私