← Back

Gas Town

Contributions to Gas Town, a multi-agent workspace manager for coding agents: race-free work dispatch at session start, helper dogs that return to idle, automatic feeding of stranded convoys and fixes to the agents' role prompts.

Year
2026
Role
Contributor
Kind
Open-source contribution
Stack
  • Go
  • tmux
  • AI agents
  • Beads

Gas Town is an open-source workspace manager that runs many LLM coding agents at once, each in its own tmux session, and keeps their work in Beads, a Git-backed issue tracker. I contributed to it in early 2026, mostly to the way work reaches an agent when its session starts.

How Gas Town works

You drive it through the gt CLI, written in Go. Agents have roles, each defined by a prompt template. The Mayor plans and files issues. Polecats are short-lived workers that take one task each. The Deacon patrols the town and keeps work moving with the help of dogs, reusable helpers that should go back to idle between jobs. Issues are grouped into convoys, and gt sling hands a piece of work to an agent by putting it on that agent's hook.

When an agent's session starts, it runs gt prime to read what is on its hook and starts working on it. Most of my changes were about that handoff.

Delayed session start

Dogs and polecats had a startup race. Their tmux session was started before the work was put on their hook, so gt prime sometimes found nothing there and the agent fell back to other work. A dog could pick up the Deacon's patrol instead of the job it was sent to do.

#1015 adds a session manager for dogs that starts the session only after the hook is set, so the agent always sees its assignment on the first prime.

Dogs that finish

A dog had no way to report that its job was done, so once it was given work it stayed “working” and could not take anything else. #1001 adds gt dog done, which clears the dog's assignment and sets it back to idle. The PR also gives dogs their own role template.

Feeding stranded convoys

With those two in place, dogs could be used for routine dispatch. #1092 adds a step to the Deacon's patrol that finds each convoy with ready issues but no worker on them, and sends a dog to feed it.

Agent prompts

Some role templates told agents to run commands that were wrong. #953 fixes several, including keeping polecats inside their own worktree.

Merged pull requests

PRChangeMerged
#953Role template fixes29 Jan 2026
#1001gt dog done: return a dog to idle29 Jan 2026
#1015Dog session manager with delayed session start29 Jan 2026
#1092Deacon patrol step that feeds stranded convoys3 Feb 2026