Trackers overview
Where your issues live. AO fetches them, assigns them to sessions, and updates them as work progresses.
The tracker plugin is how AO fetches issues, creates new ones, and links sessions to them. Three trackers ship.
GitHubIssues + PRs via the gh CLI. Default.GitLabIssues + MRs via the glab CLI. Self-hosted supported.LinearLinear issues. Direct API key or Composio-mediated.
What a tracker does
- Fetch an issue by id — used by
ao spawn 42to build the agent's prompt. - Create an issue — used by a few helper workflows (e.g. CI self-healing can file a follow-up).
- Close / comment — the agent's wrappers use these when it wraps up work.
- Return the issue URL so the dashboard can link to it.
Tracker and SCM are separate plugins on purpose — you might track issues in Linear but host code on GitHub. Just set them independently:
tracker: linear
scm: github