Repolode
gastownhall

gastownhall/gastown

基于 Go 的工作区管理器,协调 Claude Code、Copilot、Codex 等多个 AI 编码代理,并将工作状态持久化到 git 支持的 hooks 中。

Star
18,431
Fork
1,688
未关闭 Issue
508
最近提交
3天前

这是什么?

Gas Town 是一个工作区管理器,用于同时让多个 AI 编码代理在不同任务上协作。代理重启时往往会丢失上下文,Gas Town 将工作状态保存在 git 支持的 hooks(git worktree)和 Beads 账本中,使工作在崩溃或重启后仍能延续。

工作以 Town 目录(HQ)为核心组织,其中的 rig 对应一个个 git 仓库。Mayor 代理是主要协调者:用户描述目标后,它会把任务打包成 convoy,并分派给称为 polecat 的工作代理。Witness 和 Deacon 负责监控代理健康状态,Refinery 则通过二分式合并队列将完成的工作合入主分支。

项目支持 Claude Code(默认)、Codex、Gemini、Cursor 和 GitHub Copilot 等多种运行时,并提供 `gt` 命令行工具、终端活动面板、Web 仪表盘、基于 formula 的工作流以及 OpenTelemetry 遥测。

核心功能

  • 01通过 Mayor 协调者与多个工作代理协同完成任务。
  • 02将代理工作状态保存在基于 git worktree 的 hooks 中,重启后不丢失。
  • 03把 issue 打包成 convoy 并跟踪进度。
  • 04提供类 Bors 的合并队列,代理不直接推送到主分支。
  • 05通过终端活动面板和 Web 仪表盘监控卡住或失效的代理。
  • 06支持 Claude Code、Codex、Gemini、Cursor、Copilot 等多种运行时。

适用场景

  • 在多个代码仓库中并行运行 10 到 30 个 AI 编码代理。
  • 协调需要跨代理重启持续推进的多 issue 功能开发。
  • 在 AI 生成的改动合入主分支前,通过经过验证的合并队列把关。

快速上手

  1. 1

    设置 Git 身份

    git config --global user.name "Your Name" && git config --global user.email "you@example.com"
  2. 2

    创建工作区并启动服务

    gt install ~/gt --shell --git && cd ~/gt && gt up
  3. 3

    验证安装

    gt doctor --fix
  4. 4

    启动 Mayor 并告诉它要构建什么

    gt mayor attach

使用前须知

  • 原生安装需要额外工具:Go 1.26.2+、Dolt、Beads (bd)、tmux 3.0+ 以及 ICU4C 头文件。
  • 原生 Windows 最适合作为纯命令行环境;完整的 tmux 工作流需要 WSL 或 Linux。
  • macOS 上避免使用 go install,因为生成的未签名二进制会被 Gatekeeper 终止;请使用 Homebrew 或从源码构建。

标签

常见问题

gastown 是什么?
基于 Go 的工作区管理器,协调 Claude Code、Copilot、Codex 等多个 AI 编码代理,并将工作状态持久化到 git 支持的 hooks 中。 Gas Town 是一个工作区管理器,用于同时让多个 AI 编码代理在不同任务上协作。代理重启时往往会丢失上下文,Gas Town 将工作状态保存在 git 支持的 hooks(git worktree)和 Beads 账本中,使工作在崩溃或重启后仍能延续。
gastown 可以免费使用吗?用的什么许可证?
gastown 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
gastown 还在维护吗?
活跃维护中。gastown 最近一次提交是在 2026年10月18日。
gastown 适合用来做什么?
在多个代码仓库中并行运行 10 到 30 个 AI 编码代理。 协调需要跨代理重启持续推进的多 issue 功能开发。 在 AI 生成的改动合入主分支前,通过经过验证的合并队列把关。
gastown 怎么安装和运行?
设置 Git 身份: git config --global user.name "Your Name" && git config --global user.email "you@example.com" 创建工作区并启动服务: gt install ~/gt --shell --git && cd ~/gt && gt up 验证安装: gt doctor --fix 启动 Mayor 并告诉它要构建什么: gt mayor attach
在哪里获取 gastown?
源代码和安装说明在 GitHub 上:https://github.com/gastownhall/gastown

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目