Documentation

Optio is an orchestration system for AI coding agents. One primary concept — a Task — configures the agent to do something. Attach a repo and the Task drives tickets to merged PRs with an autonomous feedback loop; leave the repo off and the Task runs the agent standalone (reports, triage, automations) with no git checkout. Either flavor supports schedule, webhook, and ticket triggers, and connects agents to external services like Notion, Slack, Linear, and PostgreSQL via MCP.

New here? Start with the quickstart guide to get a local instance running in minutes.

→

Getting Started

Install Optio, run the setup script, and configure your first repository and agent.

◎

Core Concepts

Understand the architecture — pod-per-repo isolation, worktree concurrency, and the task state machine.

⚡

Guides

Step-by-step walkthroughs for creating tasks, connecting repos, configuring review agents, building workflows, setting up connections, and integrating with external tools.

⚙

Reference

API endpoints, production deployment guide, and contributor documentation.