
突发Gas Town支持多智能体编排与持久化工作跟踪Gas Town是一款工作区管理器可协调多个AI编码智能体如Claude Code、GitHub Copilot、Codex、Gemini等处理不同任务。它通过基于Git的钩子持久化工作状态实现可靠的多智能体工作流避免智能体重启时丢失上下文。解决的问题面对智能体重启丢失上下文、手动协调智能体困难、多智能体管理混乱以及工作状态丢失在智能体内存等挑战Gas Town给出了相应解决方案工作状态持久化存储在基于Git的钩子中内置邮箱、身份管理和交接机制可轻松扩展到20 - 30个智能体工作状态存储在Beads账本中。架构Gas Town的架构中包含The MayorAI协调器、Town工作区如~/gt/、Rig项目容器、Crew Members个人工作区、Polecats工作智能体、Hooks智能体工作持久化存储、Convoys工作跟踪单元、Beads集成基于Git的问题跟踪系统、Molecules工作流模板、监控系统Witness、Deacon、Dogs、Refinery合并队列处理器、Escalation问题升级机制、Scheduler调度容量管理器、Seance会话发现和继续功能以及Wasteland联邦工作协调网络。核心概念The Mayor 主要的AI协调器是Claude Code实例对工作区、项目和智能体有全面上下文了解可从这里开启任务。Town ️工作区目录包含所有项目、智能体和配置。Rigs ️项目容器包装Git仓库并管理相关智能体。Crew Members Rig内的个人工作区是实际操作的地方。Polecats 工作智能体有持久身份但会话短暂任务完成后会话结束身份和工作历史保留。Hooks 基于Git worktree的智能体工作持久化存储可在崩溃和重启后恢复。Convoys 工作跟踪单元标记为“mountain”的Convoys有自主停滞检测和智能跳过逻辑适用于大规模执行。Beads集成 基于Git的问题跟踪系统工作状态存储为结构化数据。Bead ID采用特定格式“Bead”和“issue”可互换使用。Molecules 工作流模板有仅根节点的wisps和poured wisps两种模式。监控Witness、Deacon、Dogs 三层看门狗系统确保智能体健康运行。Witness监控PolecatsDeacon后台监督Dogs执行维护任务。Refinery 合并队列处理器批量处理合并请求运行验证门限将其合并到主分支失败请求会被隔离处理。Escalation 根据严重程度进行问题升级智能体遇到阻碍时通过gt escalate升级创建跟踪Beads并通过相关角色路由。Scheduler ⏱️调度容量管理器防止API速率限制耗尽可通过配置启用延迟调度。Seance 会话发现和继续功能通过日志发现之前的智能体会话使智能体获取早期工作上下文和决策。Wasteland ️联邦工作协调网络Rigs发布需求项认领工作提交完成证据获得可移植声誉。安装先决条件安装Gas Town需要Go 1.25、Git 2.25、Dolt 2.0.7、beads (bd) 0.55.4、sqlite3、tmux 3.0、Claude Code CLI默认运行时、Codex CLI可选运行时、GitHub Copilot CLI可选运行时。安装步骤可通过Homebrew、npm或从源代码安装。不同系统安装方式有差异安装后需创建工作区、添加项目、创建团队工作区并启动Mayor会话。Docker Compose安装需设置相关环境变量进行构建、启动容器、进入容器等操作最后启动相关服务。快速入门指南开始使用运行特定命令后告诉Mayor想要构建的内容即可开始使用。基本工作流用户告诉Mayor要构建的内容Mayor创建Convoy并分配Bead给智能体智能体存储工作状态、完成工作并报告Mayor向用户总结进度。示例功能开发启动Mayor创建Convoy分配工作跟踪进度并监控智能体。常见工作流Mayor工作流推荐适用于协调复杂的多问题工作。启动Mayor告诉其要构建的内容Mayor创建Convoy和智能体监控进度完成后审查工作。最小模式不使用Tmux手动运行各个运行时实例Gas Town仅跟踪状态。Beads公式工作流适用于预定义的可重复流程通过TOML定义公式执行相关命令。手动Convoy工作流适用于直接控制工作分配手动创建Convoy添加问题分配给特定智能体并检查状态。运行时配置Gas Town支持多个AI编码运行时每个Rig的运行时设置位于settings/config.json。不同运行时有不同注意事项。关键命令工作区管理包括初始化工作区、添加项目、列出项目、创建团队工作区等命令。智能体操作有列出活动智能体、分配工作、启动Mayor会话等命令。内置智能体预设包含claude、gemini、codex等多种预设。Convoy工作跟踪有创建、列出、显示详细信息、添加问题等命令。配置可设置自定义智能体命令和默认智能体。监控与健康包括升级问题、列出未解决升级问题、显示调度器状态等命令。Beads集成有列出公式、执行公式、创建可跟踪实例等命令。Wasteland联邦有加入、查看需求板、认领工作、提交完成证据、发布需求项等命令。烹饪公式Gas Town包含常见工作流的内置公式可在internal/formula/formulas/中查看。活动馈送gt feed启动交互式终端仪表盘监控智能体活动有多种启动方式和导航操作。问题视图在大规模情况下可通过问题视图发现卡住的智能体按健康状态分组有干预键。仪表盘Gas Town包含Web仪表盘可监控工作区有多种启动方式提供工作区活动概述。监控与健康Gas Town使用三层看门狗链确保智能体健康运行包括Daemon、Boot、Deacon、Witnesses和Refineries。还有Witness、Deacon的具体职责升级机制合并队列处理调度器控制Seance功能以及Wasteland联邦的相关操作。遥测OpenTelemetryGas Town将智能体操作作为结构化日志和指标发送到OTLP兼容后端发出多种事件和指标。高级概念推进原则Gas Town使用Git钩子作为推进机制具有持久状态、版本控制、回滚能力和多智能体协调等特点。钩子生命周期钩子经历创建、活动、暂停、恢复、完成、存档等阶段。MEOWMayor增强编排工作流推荐模式包括告诉Mayor内容、分析任务、创建Convoy和智能体、分配工作、监控进度、总结结果等步骤。Shell补全可在Bash、Zsh、Fish中进行Shell补全配置。项目角色项目包含主要界面Mayor AI协调器、人类团队成员、Polecat工作智能体、Witness智能体健康监视器、Deacon监督守护进程、Refinery合并队列处理器、Hook持久化存储、Convoy工作跟踪器等角色。小贴士使用Gas Town时可从Mayor开始用Convoy协调利用钩子持久化为重复任务创建公式用gt feed监控监控仪表盘让Mayor编排。设计文档如需深入技术细节可查看docs/中的设计文档涵盖架构、术语表、Molecules等多个主题。故障排除遇到智能体失去连接、Convoy卡住、Mayor无响应等问题可采取相应解决措施。许可证本项目采用MIT许可证详情查看LICENSE文件。