gastown
brew install gastown
v1.1.0
MIT
Multi-agent workspace manager
213
30-day installs · #2556
1.8k
90-day · #1686
4.4k
365-day · #2036
16.0k
★ GitHub stars · updated 2mo ago
Runtime dependencies
Build dependencies
Links
- https://github.com/steveyegge/gastown
- GitHub: steveyegge/gastown
- Brew formula source: Formula/g/gastown.rb
Raw metadata
{
"aliases": [],
"alternatives": [],
"build_dependencies": [
"go"
],
"categories": [],
"caveats": null,
"conflicts_with": [
"genometools",
"libslax"
],
"dependencies": [
"beads",
"icu4c@78"
],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Multi-agent workspace manager",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:37:54+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "gastown",
"github_default_branch": "main",
"github_last_commit_at": "2026-06-20T10:13:49Z",
"github_readme_excerpt": "# Gas Town\n\n**Multi-agent orchestration system for Claude Code, GitHub Copilot, and other AI agents with persistent work tracking**\n\n## Overview\n\nGas Town is a workspace manager that lets you coordinate multiple AI coding agents (Claude Code, GitHub Copilot, Codex, Gemini, and others) working on different tasks. Instead of losing context when agents restart, Gas Town persists work state in git-backed hooks, enabling reliable multi-agent workflows.\n\n### What Problem Does This Solve?\n\n| Challenge | Gas Town Solution |\n| ------------------------------- | -------------------------------------------- |\n| Agents lose context on restart | Work persists in git-backed hooks |\n| Manual agent coordination | Built-in mailboxes, identities, and handoffs |\n| 4-10 agents become chaotic | Scale comfortably to 20-30 agents |\n| Work state lost in agent memory | Work state stored in Beads ledger |\n\n### Architecture\n\n```mermaid\ngraph TB\n Mayor[The Mayor\u003cbr/\u003eAI Coordinator]\n Town[Town Workspace\u003cbr/\u003e~/gt/]\n\n Town --\u003e Mayor\n Town --\u003e Rig1[Rig: Project A]\n Town --\u003e Rig2[Rig: Project B]\n\n Rig1 --\u003e Crew1[Crew Member\u003cbr/\u003eYour workspace]\n Rig1 --\u003e Hooks1[Hooks\u003cbr/\u003ePersistent storage]\n Rig1 --\u003e Polecats1[Polecats\u003cbr/\u003eWorker agents]\n\n Rig2 --\u003e Crew2[Crew Member]\n Rig2 --\u003e Hooks2[Hooks]\n Rig2 --\u003e Polecats2[Polecats]\n\n Hooks1 -.git worktree.-\u003e GitRepo1[Git Repository]\n Hooks2 -.git worktree.-\u003e GitRepo2[Git Repository]\n\n style Mayor fill:#e1f5ff,color:#000000\n style Town fill:#f0f0f0,color:#000000\n style Rig1 fill:#fff4e1,color:#000000\n style Rig2 fill:#fff4e1,color:#000000\n```\n\n## Core Concepts\n\n### The Mayor \ud83c\udfa9\n\nYour primary AI coordinator. The Mayor is a Claude Code instance with full context about your workspace, projects, and agents. **Start here** - just tell the Mayor what you want to accomplish.\n\n### Town \ud83c\udfd8\ufe0f\n\nYour workspace directory (e.g., `~/gt/`)",
"github_repo": "steveyegge/gastown",
"github_stars": 15992,
"github_topics": [],
"homepage": "https://github.com/steveyegge/gastown",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 213,
"installs_365d": 4438,
"installs_90d": 1792,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "MIT",
"llm_generated_at": null,
"llm_model": null,
"name": "gastown",
"oldnames": [],
"one_liner": null,
"optional_dependencies": [],
"rank_30d": 2556,
"rank_365d": 2036,
"rank_90d": 1686,
"raw_hash": "9fbb8f6d46b25cdf",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/g/gastown.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": "HEAD",
"version_stable": "1.1.0",
"versioned_formulae": [],
"why_use_this": null
}