gastown
Gas Town - multi-agent workspace manager
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 Create Worktrees for Exploratory Work in Gas Town: A Complete GuideLearn 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 the Witness Agent Monitors Polecats Without Becoming a Bottleneck in GastownLearn how the Witness agent monitors Polecats efficiently. Discover strategies to prevent bottlenecks by treating tmux as the source of truth and limiting continuous polling.
Polecat Lifecycle: From Work Completion to Going Idle in GastownUnderstand 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.
How the Refinery Implements the Merge Queue Strategy in Gas TownDiscover 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.
How Gas Town Stores and Manages Bead Data with the Dolt SQL ServerDiscover 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.
Agent Handoff and Seance in Gas Town: Managing Context Across Claude-Code SessionsDiscover Agent Handoff and Seance in Gas Town. Seamlessly transfer Claude-Code agent context between sessions and engage non-destructively with past conversations.
How `gt nudge` Enables Real-Time Agent Communication in Gas TownLearn 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 Sling Work to an Agent Using the `gt sling` CommandLearn how to sling work to an agent with the gastownhall/gastown gt sling command. Assign issues, validate roles, and initiate execution instantly.
How Gas Town Uses Formulas and Molecules for Workflow DefinitionLearn how Gas Town defines workflows with immutable TOML Formulas and concrete Molecule instances. Separate definition from execution for efficient agent sessions.
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.
How NDI (Nondeterministic Idempotence) Ensures Workflow Completion in Gas TownNDI ensures Gas Town workflow completion by making agents inspect persistent beads for self-healing and convergence, even with operation failures.
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:
curl -s "https://instagit.com/install.md" Maintain an open-source project? Get it listed too →