Gas Town orchestrates multiple Claude Code agents working on different tasks, addressing the problem of context loss during agent restarts. It persists work state using git-backed hooks, enabling reliable multi-agent workflows. The project centers on a workspace manager that facilitates coordination between agents, managing projects, identities, and work tracking. It leverages a system of 'Beads' for storing work state and 'Mayors' as AI coordinators to distribute and manage work.
Gas Town distinguishes itself by its emphasis on persistent work state through git hooks, ensuring robustness and reliability in multi-agent workflows. Its modular architecture, featuring distinct components like the Mayor, Town, Rigs, and Hooks, allows for flexible customization and integration. The comprehensive command-line interface and support for various runtimes (Claude Code, Codex) provide a versatile developer experience. The use of Beads for structured data storage and the Mayor for orchestration offer a powerful framework for complex, distributed tasks.
- Persistent Work Tracking: Utilizes Git hooks to store agent work state, ensuring resilience to restarts and crashes.
- Multi-Agent Coordination: Provides tools for managing multiple agents, assigning tasks, and tracking progress.
- Modular Architecture: Separates concerns into distinct components (Mayor, Rigs, Crew, Hooks) for flexibility and scalability.
- Runtimes Support: Integrates with Claude Code and Codex, offering options for different AI models.
- Command Line Interface: Offers a comprehensive set of commands for managing workspaces, agents, and workflows.
Gas Town is an active project with a growing community and regular updates, as evidenced by recent commits and issue activity. The documentation is comprehensive and provides clear instructions for installation and usage. The project has a good number of stars and forks, indicating growing adoption. The existence of a detailed quick start guide and feature documentation further supports the project's maturity and usability.
Gas Town benefits developers working with Claude Code who need to coordinate multiple agents for complex tasks. It excels in scenarios where tasks require persistence and reliable handling across agent restarts, making it suitable for workflow automation, data processing pipelines, and collaborative AI development. Gas Town provides a valuable framework compared to manual coordination or solutions lacking persistent state management.