# Install gastown with Homebrew, dnf, Nix

Multi-agent workspace manager. Version 1.1.0 via Homebrew; verified 2026-07-04.

## Install

```sh
sudo av install brew:gastown
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gastown
```

  Evidence: local Homebrew formula metadata

### Linux

- dnf (92%):

```sh
sudo dnf install gt
```

  Evidence: Fedora Rawhide package metadata: gt from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#gt
```

  Evidence: nixpkgs package indexes: pkgs/by-name/gt/gt/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:gastown
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gastown>
- **Version:** 1.1.0
- **Source summary:** Multi-agent workspace manager
- **Homepage:** <https://github.com/gastownhall/gastown>
- **Repository:** <https://github.com/gastownhall/gastown>
- **Upstream docs:** <https://github.com/gastownhall/gastown#readme>
- **License:** MIT
- **Source archive:** <https://github.com/gastownhall/gastown/archive/refs/tags/v1.1.0.tar.gz>
- **Last updated:** 2026-07-04T16:53:43+09:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- gastown (cli)
- gt (cli)
- gastown (alias)
- gt (alias)

## Dependencies

- beads
- icu4c@78

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.1.0
- Package-manager updated: 2026-07-04
- Local data: ok
- Upstream repository: https://github.com/gastownhall/gastown
- Upstream latest detected: v1.1.0 (current)
## Project history and usage

Gas Town is a Go-based multi-agent workspace manager for coordinating AI coding agents across git-backed workspaces. Its package interest comes from turning agent orchestration into a local CLI workflow, with persistent work state, agent identities, mailboxes, handoffs, and merge-queue-style project operations.

### Project history

The public repository was created in December 2025 and reached a 1.0.0 release in April 2026 after a sequence of pre-1.0 releases. The official README presents Gas Town as a workspace manager for Claude Code, GitHub Copilot, Codex, Gemini, and other agents, built around town, rig, crew, hook, convoy, and bead concepts.

Version 1.0.0 was described by the project as a production-stability milestone after iterative development. The release notes called out Windows support, workflow formulas, a GitHub pull-request merge strategy for the refinery, security hardening, mayor approval gates, and a rate-limit watchdog plugin.

### Adoption history

The official installation instructions put Homebrew first and also document npm and source builds, indicating a CLI-first distribution model aimed at developers running local agent workspaces. The README also lists Dolt, beads, tmux, Claude Code, Codex CLI, and GitHub Copilot CLI as surrounding tooling rather than treating Gas Town as a standalone binary.

### How it is used

Typical usage starts by installing `gt`, creating a town workspace, adding a git-backed rig, adding a crew workspace, and attaching the mayor session. From there the tool manages agent dispatch, persistent hooks, convoys, escalation, session discovery, and merge processing.

### Why package nerds care

Gas Town is notable as an early package-manager-distributed attempt to make multi-agent coding workflows reproducible with a conventional CLI, git worktrees, and installable dependencies. For package cataloging, it is interesting because it packages an AI-agent operating model rather than a narrow compiler, linter, or shell utility.

### Timeline

- 2025: Public GitHub repository created.
- 2026: v0.5.0 through v0.13.0 pre-1.0 releases established the early release train.
- 2026: v1.0.0 released as a production-stability milestone.
- 2026: v1.2.x releases continued shortly after 1.0.

### Related projects

- Gas Town integrates with beads for git-backed issue tracking and Dolt/DoltHub for some distributed coordination features. It is designed to orchestrate AI coding agents such as Claude Code, Codex CLI, GitHub Copilot CLI, and Gemini rather than replacing those runtimes.

### Sources

- <https://github.com/gastownhall/gastown>
- <https://github.com/gastownhall/gastown/releases>
- <https://github.com/gastownhall/gastown/releases/tag/v1.0.0>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gastown
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Conflicts With:** genometools, libslax
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - gt: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/gt/gt/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- dnf - gt - 0.4-50.fc44: installed executable or alias match | Fedora Rawhide package metadata: gt from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Modified Timidity which supportes enhanced gus format patches | http://alsa.opensrc.org/GusSoundfont
- dnf - soundfont-utils - 0.4-50.fc44: installed executable or alias match | Fedora Rawhide package metadata: soundfont-utils from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Utilities for converting from / to various soundfont formats | http://alsa.opensrc.org/GusSoundfont


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [beads](https://www.automicvault.com/pkg/brew/beads/) - Runtime dependency declared by Homebrew.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [cc-connect](https://www.automicvault.com/pkg/brew/cc-connect/) - Shares av.db curated category or tags: ai, ai-agents, cli, developer-tools.
- [desk](https://www.automicvault.com/pkg/brew/desk/) - Shares av.db curated category or tags: cli, developer-tools, workspace-management, workspace-manager.
- [docker-agent](https://www.automicvault.com/pkg/brew/docker-agent/) - Shares av.db curated category or tags: ai, ai-agents, cli, developer-tools.
- [e2b](https://www.automicvault.com/pkg/brew/e2b/) - Shares av.db curated category or tags: ai, ai-agents, cli, developer-tools.
- [langgraph-cli](https://www.automicvault.com/pkg/brew/langgraph-cli/) - Shares av.db curated category or tags: ai, ai-agents, cli, developer-tools.
- [mcphost](https://www.automicvault.com/pkg/brew/mcphost/) - Shares av.db curated category or tags: ai, cli, developer-tools, go.
- [openskills](https://www.automicvault.com/pkg/brew/openskills/) - Shares av.db curated category or tags: ai, ai-agents, cli, developer-tools.
- [strands-agents-sops](https://www.automicvault.com/pkg/brew/strands-agents-sops/) - Shares av.db curated category or tags: ai, ai-agents, cli, developer-tools.
- [ralph-orchestrator](https://www.automicvault.com/pkg/brew/ralph-orchestrator/) - Local package facts share a topical domain. Shared terms: agent, agents, ai, ai-agents, cli.
- [try](https://www.automicvault.com/pkg/brew/try/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, management, manager.

## Combined YAML source

View the package source record on GitHub. [combined/gastown.yml](https://github.com/automic-vault/db/blob/main/combined/gastown.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
