# Install gastown with Homebrew, dnf, Nix

Multi-agent workspace manager. Version 1.1.0 via Homebrew; verified 2026-07-11. Also installable with nix: nix profile install nixpkgs#gt.

## 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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-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
- **Version:** 1.1.0
- **Source summary:** Multi-agent workspace manager
- **Homepage:** <https://github.com/gastownhall/gastown>
- **Repository:** <https://github.com/gastownhall/gastown>
- **Last updated:** 2026-07-11T16:05:17+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- gastown (alias)
- gt (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.1.0
## 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

## 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-51.fc45: 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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Modified Timidity which supportes enhanced gus format patches | http://alsa.opensrc.org/GusSoundfont
- dnf - soundfont-utils - 0.4-51.fc45: 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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Utilities for converting from / to various soundfont formats | http://alsa.opensrc.org/GusSoundfont


## Combined YAML source

View the package source record on GitHub. [combined/gastown.yml](https://github.com/mxcl/pkgdb/blob/main/combined/gastown.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
