GAIA Docs

Everything a team needs to run tickets through GAIA — from the first install to the day a run gets stuck.

GuideReferenceContributingChangelog↗ (opens in a new tab)

Find your way

Quick start

From an empty machine to a ticket worked by an agent, in about ten minutes.

Start hereHow GAIA works

Control plane, conductor and run — the loop behind every ticket, in one page.

IntroductionWorking with tickets

The lifecycle, the four ways to create a ticket, labels, handoffs, and what a run does.

GuideRunning conductors

Start, watch and stop the conductor for a checkout; choose the coding agent.

GuideThe terminal UI

Operate gaia ui — dashboard, projects, tickets, runs, the new-ticket popup.

GuideSkills & WORKFLOW.md

How one skill owns each step, and how a repository says what runs and what binds.

ConceptsIntegrations

Import GitLab issues and mirror a ticket's state back as a label.

GuideTroubleshooting

The failures people actually meet — symptom, cause, the one fix.

When stuckReference

Every command and flag, both config files, workflows and states, comment types.

Reference

Where to start

• New to GAIA? Read What is GAIA — two minutes — then take the Quick start.
• Setting up a repository for your team? Connect a repository, then Author WORKFLOW.md.
• Running conductors day to day? Run a conductor and Run a ticket: from claim to done.
• Looking something up? The Reference has every command, both config files, and the workflows and states as tables; the glossary has every term.