gastown

Gas Town v1.2.0

Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), FreeBSD, and Windows.

Installation

Homebrew tap (macOS/Linux):

brew install gastownhall/gastown/gastown

Homebrew core (when autobump lands):

brew install gastown

Manual Install:
Download the appropriate binary for your platform below, extract it, and place gt in your PATH.

npm:
The npm package is not the recommended 1.2.0 install path yet. The @gastown/gt package remains behind the GitHub/Homebrew release while npm publisher access is being resolved.

Compatibility Notes

• Dolt 2.0.7 or newer is required.
• Beads bd v1.0.4 is the supported version for this release. Gas Town now fails fast if it detects a newer unsupported bd version, rather than risking schema drift against shared workspaces.
• Release archives are built CGO-disabled across the GoReleaser matrix.

Highlights

Release and Dependency Hardening

Gas Town 1.2.0 tightens the runtime dependency surface around Dolt and beads. CI, Docker, nightly integration, and release builds are pinned to the validated Dolt 2.0.7 baseline, while install and doctor flows validate the Dolt binary before beads-backed operations proceed.

The release also pins the supported beads CLI to v1.0.4 and adds an upper-version guard. If gt is started with a newer bd than this release supports, it exits with a clear downgrade instruction instead of continuing into unvalidated schema behavior.

Scheduler and Polecat Operations

Scheduler status now reports capacity as distinct working, recovery, reusable-idle, pending-MR, reservation, and free buckets. That makes it much easier to tell real saturation from reusable inventory or recovery work.

Polecat admission and reuse are stricter: capacity is enforced across platforms, active or pending MRs are respected, unsafe recovery is blocked, and ambiguous live no-issue sessions are marked for review instead of silently reused.

Daemon and Recovery Stability

The daemon now distinguishes Claude usage-limit pauses from actual crashes before restarting agents. Usage-limit signatures apply a retry delay without burning the crash-loop budget, giving quota rotation a chance to work instead of cycling healthy sessions.

Recovery and cleanup paths were hardened across stale active MRs, rename-conflict dirt, legacy tmux sockets, stuck startup sessions, and unsafe gt polecat nuke dry-runs.

Dolt, Beads, and Routing Isolation

This release reduces Dolt subprocess pressure and cross-database leakage. bd and Dolt subprocesses now get better timeout diagnostics, process-group kill reporting, read-only auto-commit isolation, startup-path reductions, and throttling under daemon, status-line, convoy, and hook workloads.

Bead creation, agent lifecycle writes, doctor prefix checks, rig prefix seeding, and route mutations now use the intended town or rig database with a sanitized environment.

Workflow, Refinery, and Agent UX

gt done preserves explicit targets, avoids spurious refinery nudges on DEFERRED, closes workflow step beads on deferred exit, clears hooks more reliably, and auto-rebases polecat branches before pushing when needed.

Autonomous agents no longer receive human-facing satisfaction prompts or away recaps. Startup behavior for Claude, OpenCode, and Gemini-backed worktrees was also tightened, including restored OpenCode startup/LSP defaults and Gemini context provisioning.

Dashboard and Web Flows

Ready work rows are slingable by the displayed ID, duplicate ready sling submissions are blocked, dashboard rig and polecat panels populate from the correct sources, and convoy fetch retry behavior is serialized.

Validation

The release tag points at 7a4fce93e93ee083444d6dbef46ba859f43a3903.

Release-candidate validation on release/v1.2.0 passed:

• E2E Tests
• Nightly Integration Tests
• git diff --check
• golangci-lint run
• go test ./internal/config -count=20 -shuffle=on
• go test ./internal/config -race -count=5 -shuffle=on
• go test -short -race -timeout=20m ./...

The final release workflow passed GoReleaser, release artifact attestation/SBOM generation, and Homebrew tap update. npm publish remains best-effort and did not publish 1.2.0.

Artifacts

This release includes:

• Linux amd64 and arm64 archives
• macOS amd64 and arm64 archives
• FreeBSD amd64 archive
• Windows amd64 zip
• SHA256 checksums
• SPDX SBOM: gastown-v1.2.0.spdx.json