Gas Town 多智能体AI编排系统

概述

Gas Town是多智能体编排系统，让一个 AI 代理（"Mayor"）管理一批专门角色的子代理并行工作，解决复杂软件开发任务。

Gas Town 不会在代理重启时丢失上下文，而是将工作状态持久化到基于 Git 的钩子中，从而实现可靠的多代理工作流。

这解决了什么问题？

架构图

核心概念

The Mayor (市长)

AI 协调员。市长是一个 Claude Code 实例，拥有关于您的工作区、项目和代理的完整上下文信息。 从这里开始 ——只需告诉市长您想要完成什么即可。

Town (城镇)

工作区目录（例如 ~/gt/ ）。包含所有项目、代理和配置。

Rigs (钻进平台)

项目容器。每个设备都封装了一个 Git 仓库并管理其关联的代理。

Crew Members (船员)

在Rigs上的个人工作区。在这里进行实际操作。

Polecats (鼬鼠)

具有持久身份但会话短暂的工作代理。它们为执行任务而生成，会话在任务完成后结束，但身份和工作历史记录会保留。

Hooks (钩子)

基于 Git 工作树的代理工作持久化存储。即使崩溃和重启也能保留数据。

Convoys (车队)

Work tracking units. Bundle multiple beads that get assigned to agents. Convoys labeled mountain get autonomous stall detection and smart skip logic for epic-scale execution.

工作跟踪单元。将多个 Beads 捆绑在一起，分配给不同的agents。标记为 mountain 的 Convoys 具备自主停滞检测和智能跳跃逻辑，可实现史诗级规模的执行。

Beads Integration (珠子整合)

基于 Git 的问题跟踪系统，将工作状态存储为结构化数据。

Bead IDs （also called issue IDs）

采用前缀加 5 位字母数字的格式（例如， gt-abc12 、 hq-x7k2m ）。前缀指示物品的来源或装备。诸如 gt sling 和 gt convoy 之类的命令接受这些 ID 来引用特定的工作项。

ps: Gastown词汇大全

安装

先决条件

• Go 1.23+

• Git 2.25+

• Dolt 1.82.4+

• Beads 0.55.4+

• Sqlite3

• Tmux 3.0+

• Claude Code

设置

1.安装 Gas Town

• brew install gastown

推荐使用 brew 安装，方便，但需要使用brew的官方源，使用清华源或阿里源可能无法找到gastown包。

• npm install -g @gastown/gt

• go install github.com/steveyegge/gastown/cmd/gt@latest

ps: 若是采用Go安装，请在 ~/.zshrc or ~/.bashrc 文件中增加:

export PATH="$PATH:$HOME/go/bin"

2.创建工作空间

gt install ~/gt --git
cd ~/gt

3.初始化工程

gt rig add myproject https://github.com/you/repo.git

4.创建crew空间

gt crew add yourname --rig myproject
cd myproject/crew/yourname

5.运行Mayor session

gt mayor attach

运行如下图，即安装成功;若未能正确运行，请执行gt doctor自检安装环境，并验证先决条件。

使用指南

工作流

示例：功能开发

# 1. Start the Mayor
gt mayor attach

# 2. In Mayor session, create a convoy with bead IDs
gt convoy create "Feature X" gt-abc12 gt-def34 --notify --human
# 创建名为 "Feature X" 的任务车队
# gt-abc12、gt-def34 是子任务的 Bead ID
# --notify  完成时发送通知
# --human   需要人工介入/审核

# 3. Assign work to an agent
gt sling gt-abc12 myproject

# 4. Track progress
gt convoy list
# 列出所有任务车队及其当前状态

# 5. Monitor agents
gt agents
# 查看所有在运行的 AI 代理（Claude / Codex 等）状态

常用工作流

1.Mayor Workflow 市长工作流

适合协调复杂的多议题工作

所需命令

# Attach to Mayor
gt mayor attach

# In Mayor, create convoy and let it orchestrate
gt convoy create "Auth System" gt-x7k2m gt-p9n4q --notify

# Track progress
gt convoy list

2.极简模式

手动运行各个运行时实例。Gas Town 只负责跟踪状态。

gt convoy create "Fix bugs" gt-abc12   # Create convoy (sling auto-creates if skipped)
gt sling gt-abc12 myproject            # Assign to worker
claude --resume                        # Agent reads mail, runs work (Claude)
# or: codex                            # Start Codex in the workspace
gt convoy list                         # Check progress

3.Beads Formula Workflow （Beads Formula 工作流）

适合预定义、可重复的流程

公式是嵌入在 gt 二进制文件中的 TOML 定义的工作流程（源位于 internal/formula/formulas/ ）。

示例文件 （internal/formula/formulas/release.formula.toml）

description = "Standard release process"
formula = "release"
version = 1

[vars.version]
description = "The semantic version to release (e.g., 1.2.0)"
required = true

[[steps]]
id = "bump-version"
title = "Bump version"
description = "Run ./scripts/bump-version.sh {{version}}"

[[steps]]
id = "run-tests"
title = "Run tests"
description = "Run make test"
needs = ["bump-version"]

[[steps]]
id = "build"
title = "Build"
description = "Run make build"
needs = ["run-tests"]

[[steps]]
id = "create-tag"
title = "Create release tag"
description = "Run git tag -a v{{version}} -m 'Release v{{version}}'"
needs = ["build"]

[[steps]]
id = "publish"
title = "Publish"
description = "Run ./scripts/publish.sh"
needs = ["create-tag"]

执行

# List available formulas
bd formula list

# Run a formula with variables
bd cook release --var version=1.2.0

# Create formula instance for tracking
bd mol pour release --var version=1.2.0

4.Manual Convoy Workflow（Manual Convoy 工作流）

适合直接控制工作分配

# Create convoy manually
gt convoy create "Bug Fixes" --human

# Add issues to existing convoy
gt convoy add hq-cv-abc gt-m3k9p gt-w5t2x

# Assign to specific agents
gt sling gt-m3k9p myproject/my-agent

# Check status
gt convoy show

运行时配置

Gas Town 支持多种 AI 编码运行时。每个设备的运行时设置位于 settings/config.json 中。

{
  "runtime": {
    "provider": "codex",
    "command": "codex",
    "args": [],
    "prompt_mode": "none"
  }
}

命令参考

工作区管理

gt install <path>           # Initialize workspace
gt rig add <name> <repo>    # Add project
gt rig list                 # List projects
gt crew add <name> --rig <rig>  # Create crew workspace

Agent 设置

gt agents                   # List active agents
gt sling <bead-id> <rig>    # Assign work to agent
gt sling <bead-id> <rig> --agent cursor   # Override runtime for this sling/spawn
gt mayor attach             # Start Mayor session
gt mayor start --agent auggie           # Run Mayor with a specific agent alias
gt prime                    # Context recovery (run inside existing session)
gt feed                     # Real-time activity feed (TUI)
gt feed --problems          # Start in problems view (stuck agent detection)

实践: 通过此设置将Agent指向deepseek, 使用如下命令：

// 首先增加Agent deepseek-XXX, 注意 deepseek-XXX 一定为可执行命令！
gt config agent set deepseek-XXX "deepseek-XXX --dangerously-skip-permissions"
// 以上运行成功后，运行此命令查看agent列表中是否有我们指定的deepseek-XXX
gt config agent list
// 将 deepseek-XXX 设置为默认 Agent
gt config default-agent deepseek-XXX

Convoy (Work Tracking)

gt convoy create <name> [issues...]   # Create convoy with issues
gt convoy list              # List all convoys
gt convoy show [id]         # Show convoy details
gt convoy add <convoy-id> <issue-id...>  # Add issues to convoy

Configuration

# Set custom agent command
gt config agent set claude-glm "claude-glm --model glm-4"
gt config agent set codex-low "codex --thinking low"

# Set default agent
gt config default-agent claude-glm

Beads Integration

bd formula list             # List formulas
bd cook <formula>           # Execute formula
bd mol pour <formula>       # Create trackable instance
bd mol list                 # List active instances

Activity Feed

gt feed 启动了一个交互式终端仪表板，用于实时监控所有代理活动。它将 Beads 活动、代理事件和合并队列更新整合到一个三面板的 TUI 中。

仪表板

Gas Town 包含一个用于监控工作区的 Web 控制面板。该控制面板必须在 Gas Town 工作区（总部）目录内运行。

# Start dashboard (default port 8080)
gt dashboard

# Start on a custom port
gt dashboard --port 3000

# Start and automatically open in browser
gt dashboard --open

仪表盘以单页概览的形式呈现工作区中的所有动态：代理、队列、钩子、队列、问题和升级。它通过 htmx 自动刷新，并包含一个命令面板，可直接从浏览器运行 gt 命令。

以上我们完成了Gastown的初步创立和使用。

ps: 测试平台为Macmini4,其余平台请在官方文档中额外参考补充。

参考

Gastown Github

附件：全命令列表