Gas Town(gt)은 AI 코딩 에이전트를 대규모로 조율하기 위한 멀티 에이전트 워크스페이스 관리 시스템이다. 에이전트가 재시작하면 컨텍스트를 잃는 문제를 git 기반 영속 저장소(Hooks)로 해결하고, 우편함(Mailbox)·식별자(Identity)·인계(Handoff) 체계로 20~30개 에이전트를 체계적으로 관리한다. Claude Code, GitHub Copilot, Codex, Gemini 등 주요 에이전트 CLI를 모두 지원한다.
핵심 개념
| 개념 | 설명 |
|---|---|
| Mayor | 전체 워크스페이스를 조율하는 주 Claude Code 인스턴스 |
| Town | 모든 프로젝트·에이전트·설정이 담기는 워크스페이스 디렉터리 |
| Rig | 개별 git 저장소를 감싸는 프로젝트 컨테이너 |
| Polecats | 영속 식별자를 가진 워커 에이전트. 세션 종료 후에도 작업 이력 보존 |
| Hooks | git worktree 기반 영속 저장소. 크래시·재시작 후에도 상태 유지 |
| Beads | git 기반 이슈 트래킹 시스템 (이슈 = 비드, ID 형식: gt-abc12) |
| Convoy | 여러 작업(비드)을 묶어 에이전트에게 일괄 할당하는 작업 추적 단위 |
문제 해결 대비
| 기존 문제 | Gas Town 해결책 |
|---|---|
| 재시작 시 컨텍스트 손실 | git Hooks에 작업 상태 영속 보존 |
| 수동 에이전트 조율 | 우편함·식별자·인계 내장 |
| 4~10개 이상에서 혼돈 | 20~30개까지 안정적 확장 |
| 작업 상태 에이전트 메모리에만 저장 | Beads 원장에 구조화 저장 |
아키텍처
Town (~/ gt/)
├── Mayor (AI 조율자)
├── Rig A (프로젝트 컨테이너)
│ ├── Crew (사용자 워크스페이스)
│ ├── Hooks (git worktree 영속 저장소)
│ └── Polecats (워커 에이전트들)
└── Rig B
└── ...모니터링 3단계
- Witness: Rig별 에이전트 생명주기 관리 및 복구 트리거
- Deacon: 백그라운드 슈퍼바이저, 전체 Rig 순찰
- Dogs: Deacon이 파견하는 유지보수 워커
설치
# Homebrew (권장, macOS)
brew install gastown
# npm
npm install -g @gastown/gt
# 소스 빌드 (Linux)
go install github.com/steveyegge/gastown/cmd/gt@latest의존성: Go 1.25+, Git 2.25+, Dolt 1.82.4+, beads 0.55.4+, tmux 3.0+
사용 대상
- 복잡한 소프트웨어 프로젝트를 여러 AI 에이전트에게 병렬 위임하고 싶은 팀
- 에이전트 재시작 시 컨텍스트 손실 문제를 겪는 개발자
- 20개 이상 에이전트를 체계적으로 관리해야 하는 대규모 AI 워크플로우