# Gas City Docs

## Docs

- [Coming from Gas Town](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/getting-started/coming-from-gastown.md): The fastest way to translate Gas Town concepts into Gas City primitives.
- [Installation](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/getting-started/installation.md): Install Gas City from Homebrew, a release tarball, or source.
- [Quickstart](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/getting-started/quickstart.md): Create a city, add a rig, and route work in a few minutes.
- [Repository Map](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/getting-started/repository-map.md): Where the main subsystems live in the Gas City repository.
- [Troubleshooting](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/getting-started/troubleshooting.md): Common installation and setup issues and how to fix them.
- [Guides](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/guides/index.md): Practical guides for common Gas City workflows.
- [PackV2: The New Package System for Gas City](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/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://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/guides/shareable-packs.md): Create, import, and customize PackV2 Gas City packs.
- [Gas City](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/index.md): Contributor-facing documentation for the Gas City orchestration SDK.
- [Supervisor REST API](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/api.md): The typed HTTP + SSE control plane exposed by the `gc` supervisor.
- [Cli](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/cli.md)
- [Config](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/config.md)
- [gc events Formats](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/events.md): Exact output formats emitted by `gc events`.
- [Exec Beads Provider](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/exec-beads-provider.md)
- [Exec Session Provider](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/exec-session-provider.md)
- [Formula Files](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/formula.md): Structure and placement of Gas City formula files.
- [Reference](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/index.md): CLI, config, formula, and provider reference material.
- [Command Execution Trust Boundaries](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/reference/trust-boundaries.md)
- [Schemas](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/schema/index.md): Machine-readable schema artifacts published with the Gas City docs.
- [Dolt Bloat Recovery](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/troubleshooting/dolt-bloat-recovery.md): Recover a Gas City beads store whose Dolt noms directory has grown out of proportion.
- [Tutorial 01 - Cities and Rigs](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/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://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/tutorials/02-agents.md): Define agents and use them to execute work.
- [Tutorial 03 - Sessions](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/tutorials/03-sessions.md): See agent output, interact directly with agents, and learn about polecats and crew.
- [Tutorial 04 - Agent-to-Agent Communication](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/tutorials/04-communication.md): How agents coordinate through mail, slung work, and hooks — without direct connections.
- [Tutorial 05 - Formulas](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/tutorials/05-formulas.md): Write declarative workflow templates with steps, dependencies, variables, and control flow, then dispatch them to agents.
- [Tutorial 06 - Beads](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/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://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/tutorials/07-orders.md): Schedule formulas and scripts to run automatically using trigger conditions — cooldowns, cron schedules, shell checks, and events.
- [Tutorials](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/tutorials/index.md): Hands-on guides for learning Gas City's core concepts.

## OpenAPI Specs

- [openapi](https://gascityinc-5c0069dd-work-default-pack-registry.mintlify.app/schema/openapi.json)