gastown

Gas Town - multi-agent workspace manager

36 articles 16.8k View on GitHub ↗
36 articles
What Is the Dispatch Command in Gas Town for Rig‑Owned Work?

Learn how the gt dispatch command moves tasks to rigs records attempts and feeds metrics back into scheduling for optimal capacity decisions and retry logic.

how-to-guide
Jul 7, 2026
How to Create Worktrees for Exploratory Work in Gas Town: A Complete Guide

Learn how to create Git worktrees for exploratory development in Gas Town. Use the gt worktree command to build isolated environments sharing a bare repository for fast experimentation.

how-to-guide
Jul 7, 2026
How the Witness Agent Monitors Polecats Without Becoming a Bottleneck in Gastown

Learn how the Witness agent monitors Polecats efficiently. Discover strategies to prevent bottlenecks by treating tmux as the source of truth and limiting continuous polling.

architecture
Jul 7, 2026
Polecat Lifecycle: From Work Completion to Going Idle in Gastown

Understand the Polecat lifecycle. Learn how Polecat completes work to going idle via gt done, terminating the session and preserving the sandbox for reuse in Gastown.

internals
Jul 7, 2026
How the Refinery Implements the Merge Queue Strategy in Gas Town

Discover how the Refinery uses a sequential rebase-and-fast-forward merge queue strategy in Gas Town. Learn about its linear history, test gating, and conflict resolution.

deep-dive
Jul 7, 2026
How Gas Town Stores and Manages Bead Data with the Dolt SQL Server

Discover how Gas Town stores and manages bead data using Dolt SQL Server. Learn about versioned rows, local directories, and Git-style syncing for efficient data handling.

how-to-guide
Jul 7, 2026
Agent Handoff and Seance in Gas Town: Managing Context Across Claude-Code Sessions

Discover Agent Handoff and Seance in Gas Town. Seamlessly transfer Claude-Code agent context between sessions and engage non-destructively with past conversations.

deep-dive
Jul 7, 2026
How `gt nudge` Enables Real-Time Agent Communication in Gas Town

Learn how gt nudge enables real-time agent communication in Gas Town. Send synchronous text payloads directly to active sessions for instant updates without Dolt commits.

how-to-guide
Jul 7, 2026
How to Sling Work to an Agent Using the `gt sling` Command

Learn how to sling work to an agent with the gastownhall/gastown gt sling command. Assign issues, validate roles, and initiate execution instantly.

how-to-guide
Jul 7, 2026
How Gas Town Uses Formulas and Molecules for Workflow Definition

Learn how Gas Town defines workflows with immutable TOML Formulas and concrete Molecule instances. Separate definition from execution for efficient agent sessions.

how-to-guide
Jul 7, 2026
What Is a Bead in Gas Town and How Is It Stored?

Discover what a Bead is in Gas Town and learn how this fundamental unit of work is stored as plain-text JSONL records within the .beads directory.

deep-dive
Jul 7, 2026
How NDI (Nondeterministic Idempotence) Ensures Workflow Completion in Gas Town

NDI ensures Gas Town workflow completion by making agents inspect persistent beads for self-healing and convergence, even with operation failures.

internals
Jul 7, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →