# Gas City Docs

## Docs

- [Coming from Gas Town](https://docs.gascityhall.com/getting-started/coming-from-gastown.md): The fastest way to translate Gas Town concepts into Gas City primitives.
- [Installation](https://docs.gascityhall.com/getting-started/installation.md): Install Gas City from Homebrew, a release tarball, or source.
- [Quickstart](https://docs.gascityhall.com/getting-started/quickstart.md): Create a city, add a rig, and route work in a few minutes.
- [Repository Map](https://docs.gascityhall.com/getting-started/repository-map.md): Where the main subsystems live in the Gas City repository.
- [Troubleshooting](https://docs.gascityhall.com/getting-started/troubleshooting.md): Common installation and setup issues and how to fix them.
- [Guides](https://docs.gascityhall.com/guides/index.md): Practical guides for common Gas City workflows.
- [PackV2: The New Package System for Gas City](https://docs.gascityhall.com/guides/migrating-to-pack-vnext.md): How to move an existing Gas City 0.14.0 city or pack to the PackV2 schema and directory conventions.
- [Shareable Packs](https://docs.gascityhall.com/guides/shareable-packs.md)
- [Gas City](https://docs.gascityhall.com/index.md): Contributor-facing documentation for the Gas City orchestration SDK.
- [Cli](https://docs.gascityhall.com/reference/cli.md)
- [Config](https://docs.gascityhall.com/reference/config.md)
- [Exec Beads Provider](https://docs.gascityhall.com/reference/exec-beads-provider.md)
- [Exec Session Provider](https://docs.gascityhall.com/reference/exec-session-provider.md)
- [Formula Files](https://docs.gascityhall.com/reference/formula.md): Structure and placement of Gas City formula files.
- [Reference](https://docs.gascityhall.com/reference/index.md): CLI, config, formula, and provider reference material.
- [Tutorial 01 - Cities and Rigs](https://docs.gascityhall.com/tutorials/01-cities-and-rigs.md): Create a city, sling work to an agent, add a rig, and configure multiple agents.
- [Tutorial 02 - Agents](https://docs.gascityhall.com/tutorials/02-agents.md): Define agents and use them to execute work.
- [Tutorial 03 - Sessions](https://docs.gascityhall.com/tutorials/03-sessions.md): See agent output, interact directly with agents, and learn about polecats and crew.
- [Tutorial 04 - Agent-to-Agent Communication](https://docs.gascityhall.com/tutorials/04-communication.md): How agents coordinate through mail, slung work, and hooks — without direct connections.
- [Tutorial 05 - Formulas](https://docs.gascityhall.com/tutorials/05-formulas.md): Write declarative workflow templates with steps, dependencies, variables, and control flow, then dispatch them to agents.
- [Tutorial 06 - Beads](https://docs.gascityhall.com/tutorials/06-beads.md): Understand the universal work primitive that underlies sessions, mail, formulas, and convoys — and learn to query and manipulate work items directly.
- [Tutorial 07 - Orders](https://docs.gascityhall.com/tutorials/07-orders.md): Schedule formulas and scripts to run automatically using gate conditions — cooldowns, cron schedules, shell checks, and events.
- [Tutorials](https://docs.gascityhall.com/tutorials/index.md): Hands-on guides for learning Gas City's core concepts.

## OpenAPI Specs

- [openapi](https://docs.gascityhall.com/api-reference/openapi.json)