# gastown | Gas Town Hall | Knowledge Base | Instagit Gas Town - multi-agent workspace manager GitHub Stars: 16.8k Repository: https://github.com/gastownhall/gastown --- ## Articles ### [What Is the Dispatch Command in Gas Town for Rig‑Owned Work?](/gastownhall/gastown/what-is-the-purpose-of-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. - Tags: how-to-guide - Published: 2026-07-07 ### [How to Create Worktrees for Exploratory Work in Gas Town: A Complete Guide](/gastownhall/gastown/how-can-developers-create-worktrees-for-exploratory-work-in-gas-town) 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. - Tags: how-to-guide - Published: 2026-07-07 ### [How the Witness Agent Monitors Polecats Without Becoming a Bottleneck in Gastown](/gastownhall/gastown/how-does-the-witness-agent-monitor-polecats-without-becoming-a-bottleneck) 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. - Tags: architecture - Published: 2026-07-07 ### [Polecat Lifecycle: From Work Completion to Going Idle in Gastown](/gastownhall/gastown/describe-the-polecat-lifecycle-from-work-completion-to-going-idle) 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. - Tags: internals - Published: 2026-07-07 ### [How the Refinery Implements the Merge Queue Strategy in Gas Town](/gastownhall/gastown/what-is-the-merge-queue-strategy-used-by-the-refinery-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. - Tags: deep-dive - Published: 2026-07-07 ### [How Gas Town Stores and Manages Bead Data with the Dolt SQL Server](/gastownhall/gastown/how-is-bead-data-stored-and-managed-by-dolt-sql-server-in-gas-town) 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. - Tags: how-to-guide - Published: 2026-07-07 ### [Agent Handoff and Seance in Gas Town: Managing Context Across Claude-Code Sessions](/gastownhall/gastown/what-is-agent-handoff-and-seance-in-gas-town) Discover Agent Handoff and Seance in Gas Town. Seamlessly transfer Claude-Code agent context between sessions and engage non-destructively with past conversations. - Tags: deep-dive - Published: 2026-07-07 ### [How `gt nudge` Enables Real-Time Agent Communication in Gas Town](/gastownhall/gastown/how-does-gt-nudge-command-facilitate-real-time-agent-communication) 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. - Tags: how-to-guide - Published: 2026-07-07 ### [How to Sling Work to an Agent Using the `gt sling` Command](/gastownhall/gastown/how-do-i-sling-work-to-an-agent-using-gt-sling) Learn how to sling work to an agent with the gastownhall/gastown gt sling command. Assign issues, validate roles, and initiate execution instantly. - Tags: how-to-guide - Published: 2026-07-07 ### [How Gas Town Uses Formulas and Molecules for Workflow Definition](/gastownhall/gastown/how-does-gas-town-use-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. - Tags: how-to-guide - Published: 2026-07-07 ### [What Is a Bead in Gas Town and How Is It Stored?](/gastownhall/gastown/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. - Tags: deep-dive - Published: 2026-07-07 ### [How NDI (Nondeterministic Idempotence) Ensures Workflow Completion in Gas Town](/gastownhall/gastown/how-does-ndi-ensure-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. - Tags: internals - Published: 2026-07-07 ### [What Is the GUPP Principle and How Does It Ensure Agent Autonomy?](/gastownhall/gastown/what-is-the-gupp-principle-and-how-does-it-ensure-agent-autonomy) Discover the GUPP principle and how it enables agent autonomy. Explore its pull-based, crash-surviving execution model that eliminates central orchestration for decentralized systems. - Tags: deep-dive - Published: 2026-07-07 ### [Understanding the MEOW Principle for Breaking Down Work in Gas Town](/gastownhall/gastown/explain-the-meow-principle-for-breaking-down-work-in-gas-town) Master the MEOW principle to break down complex tasks into actionable Beads for autonomous agents. Streamline your workflow with this powerful Gas Town technique and achieve seamless execution. - Tags: concept-explanation - Published: 2026-07-07 ### [Deacon Agent in Gas Town Health Monitoring: Architecture and Responsibilities](/gastownhall/gastown/what-is-the-role-of-the-deacon-agent-in-gas-towns-health-monitoring) Discover the Deacon agent's role in Gas Town health monitoring discover its architecture and how it supervises system liveness and automated recovery. - Tags: architecture - Published: 2026-07-07 ### [How the Mayor Agent Functions as a Global Coordinator in Gastown](/gastownhall/gastown/how-does-the-mayor-agent-function-as-a-global-coordinator) Discover how the Mayor agent in Gastown acts as a global coordinator. Learn about its role in work dispatch, escalation management, and state visibility for efficient system operation. - Tags: architecture - Published: 2026-07-07 ### [Gas Town Agent Types and Their Scopes: A Complete Guide to the AI Worker Hierarchy](/gastownhall/gastown/what-are-the-different-agent-types-in-gas-town-and-their-scopes) Explore Gas Town agent types and their scopes. Understand the hierarchy of Town level and Rig level AI workers managing operations across rigs and within individual rigs. - Tags: deep-dive - Published: 2026-07-07 ### [What Is routes.jsonl in Gas Town? The Complete Guide to the Central Routing Table](/gastownhall/gastown/what-is-the-function-of-routes.jsonl-in-gas-towns-routing-system) Discover the function of routes.jsonl in Gas Town. This guide explains how the central routing table maps bead prefixes to filesystem paths for efficient command, plugin, and mail delivery. - Tags: deep-dive - Published: 2026-07-07 ### [How Rig-Level Beads Are Organized and Prefixed in Gas Town](/gastownhall/gastown/how-are-rig-level-beads-organized-and-prefixed-in-gas-town) Discover how Gas Town organizes rig level beads using configurable prefixes defined in rigs.json. Learn about namespaces isolation and work history. - Tags: internals - Published: 2026-07-07 ### [How Town-Level Beads Are Organized and Prefixed in Gas Town: A Complete Guide](/gastownhall/gastown/how-are-town-level-beads-organized-and-prefixed-in-gas-town) Discover how town-level beads are organized and prefixed in Gas Town. Learn about hidden directories, route prefixes, and root resolution for efficient management. - Tags: how-to-guide - Published: 2026-07-07 ### [Understanding the Two-Level Beads System in Gas Town](/gastownhall/gastown/what-is-the-purpose-of-the-two-level-beads-system-in-gas-town) Discover the two-level beads system in Gas Town. Isolate coordination and project work, enable fast messaging, and maintain global state. Learn how it works. - Tags: deep-dive - Published: 2026-07-07 ### [How Gas Town Orchestrates AI Agents Across Repositories](/gastownhall/gastown/how-does-gas-town-orchestrate-ai-agents-across-repositories) Discover how Gas Town orchestrates AI agents across repositories. Learn about the Mayor, Convoys, Polecats, and Witness roles in managing distributed workflows. - Tags: architecture - Published: 2026-07-07 ### [How the cmd Directory Fits into the Gas Town Architecture](/gastownhall/gastown/how-does-the-cmd-directory-relate-to-the-overall-architecture-of-gastownhall-gastown) Understand the cmd directory's role in the Gas Town architecture. Discover how it manages executables and powers the gt CLI and mTLS proxy for secure container communication. - Tags: architecture - Published: 2026-07-07 ### [Custom Commands in gastownhall/gastown: How to Extend the gt CLI](/gastownhall/gastown/are-there-any-examples-of-custom-commands-in-gastownhall-gastown-s-cmd-directory) Extend the gt CLI with custom commands in gastownhall/gastown. Discover how to add new subcommands easily by leveraging the pluggable command architecture in the cmd directory. - Tags: how-to-guide - Published: 2026-07-07 ### [Output Format of the Commands in the gastownhall/gastown cmd Directory](/gastownhall/gastown/what-is-the-output-format-of-the-commands-in-the-gastownhall-gastown-cmd-directory) Understand the output format of gastownhall gastown commands. Learn how plain-text and internal JSON formats are used for efficient command-line interaction and data exchange. - Tags: api-reference - Published: 2026-07-07 ### [How to Parse Arguments for Commands in gastownhall/gastown](/gastownhall/gastown/how-to-parse-arguments-for-commands-in-gastownhall-gastown) Learn how to parse command-line arguments in gastownhall/gastown using Cobra. Discover structured definitions, flag registration, and positional argument validation. - Tags: how-to-guide - Published: 2026-07-07 ### [How to Contribute New Commands to the Gastown CLI via the cmd Directory](/gastownhall/gastown/how-can-i-contribute-new-commands-to-the-gastownhall-gastown-project-via-the-cmd-directory) Learn to contribute new commands to the gastownhall/gastown project. Add your own Go commands to the cmd directory and register them with the root command easily. - Tags: how-to-guide - Published: 2026-07-07 ### [Does the cmd Directory in gastownhall/gastown Contain Utility Functions?](/gastownhall/gastown/does-the-cmd-directory-in-gastownhall-gastown-contain-utility-functions) Discover if the cmd directory in gastownhall/gastown houses utility functions. Learn about the bdCmd builder for subprocess execution and environment management. - Tags: how-to-guide - Published: 2026-07-07 ### [Error Handling for Commands in gastownhall/gastown's CLI: A Complete Guide](/gastownhall/gastown/how-is-error-handling-implemented-for-commands-in-gastownhall-gastown-s-cmd-directory) Learn expert error handling for gastownhall/gastown CLI commands. Discover how to use Cobra's RunE pattern for robust, informative error messages and proper exit codes. - Tags: how-to-guide - Published: 2026-07-07 ### [What Dependencies Are Associated with the Commands in gastownhall/gastown's cmd Directory?](/gastownhall/gastown/what-dependencies-are-associated-with-the-commands-in-gastownhall-gastown-s-cmd-directory) Discover the dependencies for gastownhall/gastown commands. Learn how this project leverages the Go standard library and internal packages, eliminating third-party dependencies for a cleaner codebase. - Tags: deep-dive - Published: 2026-07-07 ### [Main Entry Points for the gastownhall/gastown Application in the cmd Directory](/gastownhall/gastown/what-are-the-main-entry-points-for-the-gastownhall-gastown-application-located-in-the-cmd-directory) Discover the main entry points for the gastownhall/gastown application within the cmd directory: gt CLI, gt-proxy-server, and gt-proxy-client. Learn how to use them. - Tags: architecture - Published: 2026-07-07 ### [How Commands Are Organized in the gastownhall/gastown cmd Directory](/gastownhall/gastown/how-are-the-commands-organized-in-the-gastownhall-gastown-cmd-directory) Discover how gastownhall/gastown cmd commands are organized using Cobra. Learn about root commands and modular sub-command registration via Go init() functions. - Tags: internals - Published: 2026-07-07 ### [What Files Are Typically Found in the cmd Directory of a Go Project?](/gastownhall/gastown/what-kind-of-files-are-typically-found-in-the-cmd-directory-of-a-go-project-like-gastownhall-gastown) Discover files within a Go project's cmd directory. Learn how each sub-directory, including main.go, creates unique binaries, config, and tests for your Go applications. - Tags: how-to-guide - Published: 2026-07-07 ### [Subdirectories in the cmd Directory of gastownhall/gastown: A Complete Guide](/gastownhall/gastown/are-there-any-specific-subdirectories-within-the-cmd-directory-of-gastownhall-gastown) Explore the cmd directory in gastownhall/gastown. Discover the subdirectories gt, gt-proxy-server, and gt-proxy-client for Gas Town system command-line access. - Tags: how-to-guide - Published: 2026-07-07 ### [What Is the Purpose of the cmd Directory in gastownhall/gastown?](/gastownhall/gastown/what-is-the-purpose-of-the-cmd-directory-in-gastownhall-gastown) Discover the purpose of the cmd directory in gastownhall/gastown. It houses entry-point executables for the main gt CLI and secure proxy binaries for safe container command execution. - Tags: internals - Published: 2026-07-07 ### [How to Use the gastownhall/gastown cmd Directory: Building and Running Gas Town CLI Tools](/gastownhall/gastown/how-to-use-gastownhall-gastown-cmd-directory) Learn to use the gastownhall/gastown cmd directory to build and run Gas Town CLI tools including gt, gt-proxy-server, and gt-proxy-client for your project. - Tags: how-to-guide - Published: 2026-07-07