gastown

管理Claude Code的多代理编排器。当用户提到gastown、gas town、gt命令、bd命令、convoys、polecats、crew、rigs、slinging work、多代理协调、beads、hooks、molecules、workflows、the witness、the mayor、the refinery、the deacon、dogs、升级或希望同时在项目上运行多个AI代理时使用。处理安装、工作区设置、工作跟踪、代理生命周期、崩溃恢复以及所有gt/bd CLI操作。可以通过诸如“gas town”、“gt sling”、“fire up the engine”等短语触发。

Gastown

Overview

Gas Town is a multi-agent orchestration system for Claude Code that enables parallel AI workers to execute tasks simultaneously. It provides work tracking through beads, agent lifecycle management via polecats and crew, and automated code merging through the Refinery.

Prerequisites

Go 1.21+ installed for CLI tools (gt and bd)
Git configured with SSH or HTTPS access
Terminal access for running commands
Sufficient disk space for workspace (~100MB for ~/gt)
GitHub account for repository integration (optional)

Instructions

Install Gas Town CLI tools (gt and bd) using Go
Create your workshop directory at ~/gt
Run diagnostics with gt doctor and bd doctor
Add a project as a rig using gt rig add
Create work items as beads using bd create
Sling work to agents using gt sling
Monitor progress with gt status and gt peek
Let the Refinery merge completed work

The Cognition Engine. Track work with convoys; sling to agents.

Output

Executed gt and bd commands with results reported to user
Engine status reports showing system health and worker states
Work tracking updates (beads created, assigned, completed)
Polecat and crew lifecycle events (spawn, completion, termination)
Diagnostic results from gt doctor and bd doctor
Merge pipeline status from Refinery operations

Error Handling

See {baseDir}/references/errors.md for comprehensive error handling.

Examples

See {baseDir}/references/examples.md for detailed examples.