gobby (Gobby AI)

Gobby Start with a task. Walk away. End with a PR.

______________________________________________________________________

gobby build '#1842'

这就是循环。手抓任务，走开，回来做公关。

在这个命令的背后：一个计划，一个分阶段子任务的扩展，孤立的 工作树、派遣代理、挂钩时间护栏、验证、审查门、， 以及一个紧密相连的承诺。如果有什么东西脱轨了，戈比就会停下来 升级而不是合并垃圾。

Gobby建造了Gobby。 5K+次提交。我的项目中有15K多个任务。二 在其上运行生产系统的付费客户。0.4.x生产线已组装完成 通过Gobby自己的任务、调度、审查和文档流—— 收据存在于该回购中 .gobby/tasks.jsonl.

______________________________________________________________________

为什么存在

人工智能编码的瓶颈很久以前就不再是模型能力了。这 瓶颈是保姆。代理在契约中失去了上下文。他们漂流 从你在CLAUDE.md中写的规则中。它们重复工作。它们燃烧 每轮都有数千个令牌重新加载相同的MCP模式。您仍在审核 每一个差异都是因为你不能真正相信回来的东西。

修复并不是一个更好的提示。解决方案是围绕代理的基础设施。

Gobby是一个本地守护进程，位于您已经使用的AI编码CLI下方 --Claude Code、Codex、Gemini CLI、Qwen CLI、Factory Droid——并为他们提供 它们缺失了：共享会话、持久任务分类账、挂钩时间规则， 渐进式MCP发现、代理隔离、审查门和构建循环 在没有你在中间的情况下把任务变成公关。

它是 不是另一个代理人。 你已经是特工们的控制飞机了 有人不见了。

______________________________________________________________________

什么是Gobby

您在本地运行的Python 3.13+守护进程。SQLite位于 ~/.gobby/gobby-hub.db. HTTP和上安装的web UI :60887，打开WebSocket :60888，开发web UI 上 :60889，您的编码CLI与之通信的stdio MCP服务器。

Gobby承重有三件事：

1.阶段清单调度+挂钩时间规则

大多数自主代理都是一个巨大的提示循环，模型在其中做出决定 一切。这就是你已经经历过的失败模式。

Gobby将运行时一分为二。调度是 确定性的：心跳 扫描任务，读取当前阶段清单行(ideation → research → architecture → prd → planning → expansion → development → holistic_qa → pr → merge)，评估中的有序规则 src/gobby/dispatch/rules.py，获取每个任务的互斥体，并执行一个 有界动作——启动一个阶段，生成一个代理，创建隔离，前进， 逐步升级。没有提示，就没有模特自由职业。

在生成的worker中，代理将满 自主 计划、编辑、， 验证并提交。但每个工具调用都会通过规则引擎 turn_start, before_tool, after_tool，以及 turn_end规则可以阻止， 同步重写、注入上下文或设置变量。它们被评估为 代码，不希望出现在提示中。

强制边界内的代理人自由。这是唯一的办法 gobby build 可以“放手”而不撒谎。

2.本地优先，自建

您的数据库、成绩单、钩子、任务分类账、工作流和规则将保留 你的机器。没有云控制飞机。不依赖SaaS。Apache 2.0。

您正在阅读的repo是通过它自己的构建循环构建的。5K+次提交。 15K+任务。0.4.x是由通过分阶段工作的衍生代理组装的 清单，与调度员进行路线审查和合并。这就是生产 测试台：调度、钩子、隔离或任务生命周期中的每个回归 第二天早上，它显示为一个停滞的建筑。

我还用它为两个付费客户运送生产系统。正是 我需要一个工具来真正信任人工智能编码代理在实际工作中的输出。

3.坐在CLIs下面，而不是旁边

Aider、Cline、OpenHands、Plandex、BMAD-METHOD——这些 *是* 代理人。他们 拥有CLI、循环和上下文窗口。转换意味着重新学习 工作流程。

并行运行程序，如Superset、并行代码和claude_code_bridge启动 多个CLIs并排放置在工作树上，但每个CLIs仍然是自己的岛屿 具有自己的会话、内存和任务状态。

Gobby是下面的一层。相同的守护进程，相同的任务分类账，相同的 内存和相同的规则引擎为您使用的每个CLI提供服务。任务开始于 克劳德代码可以在Codex中声明，并在Droid中完成，而不会丢失 上下文、验证门或审核状态。你不能从中挑一个赢家 编码CLIs；你选择最适合你面前工作的东西，戈比继续 他们连贯。

______________________________________________________________________

如何 gobby build 实际上有效

gobby build '#1842'                          # plan, epic, or leaf task
gobby build plans/auth-refactor.md --quick   # straight from a plan file
gobby build stop '#1842'                     # task-scoped controls

引擎盖下：

1. 构建状态 写在任务上： allow_automation=true,

隔离(none / worktree / clone)，指定代理，目标分支。 在打开此门之前，积压任务是惰性的。

1. 舞台清单 从登记处物化到 task_stage_states.

每一行都包含位置、状态(ready / in_progress / needs_review / review_approved / done)、审核策略、审核者和尝试计数器。

1. 心跳 扫描已选择的任务，筛选出索赔/租赁/升级的任务/

依赖性阻止工作，读取当前阶段行，并让其排序 确定性规则在互斥体下只选择一个动作。

1. 代理运行 在工作台上或完全复制。工具调用通过

规则引擎。技能按需加载。内存和代码图结果注入 只有在相关的时候。

1. 审查 是舞台原住民。工人 submit_for_review 而不是关闭

直接；下一个心跳产生配置的审阅者；批准 推进行；拒绝重试或升级。

1. 关闭 需要承诺。如果你更改了文件，你就提交它们——

守护进程不会让带有差异且没有SHA的叶子关闭。

调度员不会起草计划、在线修复工件或提示 模型。提示属于衍生代理。路由属于调度。 保持这条线的干净是使整个事情值得信赖的原因。

______________________________________________________________________

工具链（姐妹仓库）

Gobby附带了一组Rust二进制文件 GobbyAI/gobby-cli 这解决了 代理人在实践中遇到的非魅力问题。它们分别安装， 但戈比会帮你把它们连接起来。

再加上渐进式MCP代理本身，它只在工具 实际上被调用，而不是在每个列表上。这是另一个3-40K代币 平均会话从不需要花费。

这些不是副业。代币税是阻止代理人的东西 在真正的代码库上完成真正的工作，工具链就是护城河的一部分。

______________________________________________________________________

Gobby如何比较

诚实的总结：如果你已经选择了一个你喜欢的编码CLI，Gobby 使其更加可靠。如果你想将其中几个用于不同的工作， Gobby是唯一让他们保持连贯的东西。如果你想发送任务 Gobby是唯一一个进入构建循环并获得PR的开源项目 我知道这在当地是这样做的。

______________________________________________________________________

0.4.x版本中的发货内容

0.4.x是完成全部任务的第一个发布行→ 支持PR循环 路径，而不是高级用户的把戏。

• gobby build 作为单一入口点：CLI、MCP和HTTP都可以解析

使用相同的共享构建服务 BuildResult 形状。档案 (quick, review, full, full-yolo)，任务范围控件(stop, resume, clean, restart)，分支清理，重试恢复。

• 阶段原生生命周期: task_stage_states, task_dispatch_mutex,

task_artifacts, task_lifecycle_events.审查判决附于 清单行。PR和合并交付工件。

• Droid工厂 作为一流的CLI源——钩子、会话、转录本，

催生代理，网络聊天平价。

• 基于运行的任务扩展 具有可配置的深度、五层天花板，

扩展QA覆盖范围清单和库存检查。

• 按需加载技能技能中心（SkillsMP、GitHub支持的安装），

简洁注入、验证/审查技能模式。

• 内存和代码图维护：过时的内存审计员，异步知识-

图重建、嵌入健康、代码索引刷新。

• 可观测性 用于会话、模型、令牌、跟踪、本地模型状态，

以及内置的跟踪查看器。

• Web 用户界面 跨聊天、会话、任务、工作流、cron的改进，

项目——包括320px紧凑布局和共享设计令牌。

完整发行说明： 更改日志.md.

______________________________________________________________________

建筑

• Python 3.13+守护进程(uv 一切）
• SQLite位于 ~/.gobby/gobby-hub.db
• 上的HTTP API和已安装的web UI localhost:60887，打开WebSocket :60888,

打开开发web UI :60889

• 用于编码助手的stdio MCP服务器
• 适用于Claude Code、Codex、Gemini CLI、Qwen CLI、Factory Droid的钩子适配器
• 可选Qdrant+FalkorDB，用于矢量和图形支持的搜索
• 配套Rust工具链通过 gobby cli

SQLite数据库位于 ~/.gobby/gobby-hub.db 是任务的真理之源 国家。 .gobby/tasks.jsonl 是git原生同步投影——已签入， 在PR中存在差异，并与DB协调，因此任务链接的提交得以保留 跨机器可审计。线性支持作为可选的外部同步 针对已经在那里跟踪工作的团队。

指南集是行为的真理来源：

• docs/guides/tasks.md --任务生命周期、验证、提交链接关闭
• docs/guides/dispatch.md --阶段清单调度与规则链
• docs/guides/orchestration.md --构建、代理、隔离、审查
• docs/guides/sessions.md --会话生命周期和切换
• docs/guides/mcp-tools.md --MCP代理和渐进式发现
• 文档/指南/工作流程概述.md --规则、代理人、管道、调度
• 文档/指南/系统要求.md --先决条件

看 docs/guides/README.md 查看完整的指南索引。

______________________________________________________________________

支持的CLIs

在其中任何一个中启动的任务都可以在任何其他任务中继续执行 本地状态、验证门和审核状态。

本地模型提供商（LM Studio、Ollama）通过相同的钩子和MCP工作 层，只要底层CLI支持OpenAI兼容端点。

______________________________________________________________________

安装

尝试不安装：

uvx gobby --help

全局安装：

# With uv (recommended)
uv tool install gobby

# With pipx
pipx install gobby

# With pip
pip install gobby

0.4.x系列需要Python 3.13+。

______________________________________________________________________

快速开始

从项目目录中：

gobby start                  # start the daemon
gobby install                # detect supported CLIs and wire hooks + MCP
gobby init                   # initialize .gobby/ for this repo

gobby install 使用相同的stdio MCP服务器配置每个检测到的CLI：

{
  "mcpServers": {
    "gobby": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "gobby", "mcp-server"]
    }
  }
}

打开已安装的web UI http://localhost:60887/ 一旦守护进程运行。 这 :60889 UI端口用于 gobby ui dev 在前端开发期间。

然后，在您选择的CLI中开始交互式工作——Gobby会跟踪它 悄悄地——或者给它一个任务，让构建循环运行：

gobby tasks create "Add OAuth refresh-token rotation" --type feature --category code
gobby build '#'

有关此存储库中的代理操作说明，请阅读 CLAUDE.md.

______________________________________________________________________

它要去哪里

0.4.x是平台基线。下一步工作是硬化 基线，然后将热路径移植到Rust，然后打开多机和 团队表面。

-0.4.x后：硬化

• PostgreSQL中心迁移 (#12761)--替换SQLite作为运行时中心

随着 psycopg v3， pg_search，双后端测试，一次拍摄 冷切换迁移工具。分阶段进行基线换热、维修 引导、双后端测试、模式和查询奇偶校验、迁移工具， 切换和回滚。

• FalkorDB图迁移 (#12746)--将Neo4j替换为FalkorDB

守护进程写入、Rust读取客户端、web UI、管理有效负载和设置 男巫

• 记忆回忆助手 (#12898)--有界背景辅助代理

每轮搜索内存，并将新结果注入父级 会议。

• 规划注册表API和UI编辑器 (#14140)--展示舞台并构建-

通过API和编辑界面配置文件注册表，使生命周期形状可以 无需手动编辑存储即可进化。

• 附加会话UX奇偶校验 使用一流的网络聊天：上下文使用

指示器、模式/型号同步、附件中继、角色切换、STT/TTS。

• 日志清理 在执行日志格式规则之前：配置重置，

运行时与应用程序日志分离、规范化处理程序、自动化日志 cron和dispatch。

0.5.0：锈蚀迁移

扼杀者迁移，而不是重写。Python仍然是公共守护进程 行为参考，直到每个边界通过奇偶性、可观察性和 回滚门。Rust sidecar在内部端口上运行，Python委派 在明确标志后面选择路线族。比较模式同时运行和 返回Python响应，直到奇偶校验被证明。

桥头已存在于 gobby cli: gcode, gsqz, gloc, ghook，加 gobby-core 共享图元。 0.5.0 将其扩展到守护进程本身。

稍后

• 专业同步和多守护进程 --任务、内存和

会话元数据；多守护进程发现和握手；车队库存， 健康和远程指挥；共享任务板、团队工作流、审计和 企业控制。这是商业层。

• 原生应用 --具有托盘生命周期和捆绑守护进程的桌面应用程序；

用于观察会议、审查任务和批准的移动伴侣 远程门。

• 生态系统 --公共插件注册表、特定于堆栈的启动器包（钩子，

工作流、技能、任务模板）、其他CLI集成。

• SWE试验台评估 (docs/plans/SWE-BENCH.md)--eval运行/结果

存储， gobby eval CLI、Docker支持的工具、轨迹捕获、， Gobby启用与基线A/B测试。

完整计划： ROADMAP.md.

______________________________________________________________________

地位和贡献

Gobby是1.0之前的版本，并且发展迅速。0.4.x线是我运行和发货的起点 每天，但API、配置、工作流定义和钩子行为 将随着守护进程的硬化而继续变化。如果这对你来说是个问题， 等待1.0。如果你想影响它的形状，现在就跳进去。

Apache 2.0已获得许可。看 贡献.md 为了发展 指导。

______________________________________________________________________

Built with Gobby. By a human and a lot of agents, working in the same repo.