# Agent Orchestrator

## Docs

- [Agent](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/agent.md): Plugin interface for AI coding agent adapters (Claude Code, Codex, Aider, OpenCode) with launch, activity detection, and session info
- [Config Loader](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/config-loader.md): Load and validate agent-orchestrator.yaml configuration with Zod schemas
- [Event System](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/event-bus.md): Orchestrator event types, priorities, and notification routing
- [Lifecycle Manager](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/lifecycle-manager.md): State machine and reaction engine for orchestrating agent session lifecycles
- [Notifier](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/notifier.md): Plugin interface for push notifications (desktop, Slack, webhooks) - the primary interface between orchestrator and humans
- [Runtime](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/runtime.md): Plugin interface for runtime execution environments where agent sessions execute (tmux, docker, kubernetes, processes)
- [SCM](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/scm.md): Plugin interface for source control management platforms (GitHub, GitLab) with PR lifecycle, CI tracking, code review, and merge readiness
- [Session](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/session.md): Core session interface representing a running agent session with lifecycle state, activity tracking, and metadata
- [Session Manager](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/session-manager.md): CRUD operations for agent sessions - spawn, restore, list, kill, and send messages
- [Terminal](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/terminal.md): Plugin interface for terminal UI integrations (iTerm2, web) that manage how humans view and interact with running agent sessions
- [Tracker](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/tracker.md): Plugin interface for issue tracking integrations (GitHub Issues, Linear, Jira) with issue fetching, branch naming, and prompt generation
- [Workspace](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api/workspace.md): Plugin interface for workspace isolation strategies (git worktree, clone) providing each session with an isolated copy of the repository
- [ao dashboard](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/dashboard.md): Start the web dashboard for monitoring and managing agent sessions
- [ao init](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/init.md): Interactive setup wizard for creating agent-orchestrator.yaml configuration
- [ao open](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/open.md): Open session(s) in terminal tabs
- [CLI Overview](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/overview.md): Command-line interface for managing Agent Orchestrator sessions
- [ao review-check](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/review-check.md): Check PRs for review comments and trigger agents to address them
- [ao send](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/send.md): Send messages to running agent sessions with busy detection and retry
- [ao session](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/session.md): Manage agent sessions with ls, kill, cleanup, and restore commands
- [ao spawn](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/spawn.md): Create new agent sessions for issues with automatic workspace setup
- [ao start / ao stop](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/start-stop.md): Start and stop the orchestrator agent and web dashboard
- [ao status](https://mintlify.wiki/ComposioHQ/agent-orchestrator/cli/status.md): View all sessions with branch, activity, PR, and CI status
- [Architecture](https://mintlify.wiki/ComposioHQ/agent-orchestrator/concepts/architecture.md): Understanding the plugin-based architecture of Agent Orchestrator
- [Plugins](https://mintlify.wiki/ComposioHQ/agent-orchestrator/concepts/plugins.md): Understanding the plugin system and how to use different plugin implementations
- [Sessions](https://mintlify.wiki/ComposioHQ/agent-orchestrator/concepts/sessions.md): Understanding session lifecycle, states, and management in Agent Orchestrator
- [Workflows](https://mintlify.wiki/ComposioHQ/agent-orchestrator/concepts/workflows.md): Understanding typical workflows and how sessions progress through their lifecycle
- [Notification Configuration](https://mintlify.wiki/ComposioHQ/agent-orchestrator/configuration/notifications.md): Route notifications to Slack, Discord, webhooks, and custom channels
- [Configuration Overview](https://mintlify.wiki/ComposioHQ/agent-orchestrator/configuration/overview.md): Learn how to configure Agent Orchestrator with agent-orchestrator.yaml
- [Project Configuration](https://mintlify.wiki/ComposioHQ/agent-orchestrator/configuration/projects.md): Configure projects with repositories, branches, trackers, and per-project overrides
- [Reaction Configuration](https://mintlify.wiki/ComposioHQ/agent-orchestrator/configuration/reactions.md): Auto-responses to CI failures, review comments, and agent events
- [Auto-Reactions](https://mintlify.wiki/ComposioHQ/agent-orchestrator/guides/auto-reactions.md): Configure automated responses to CI failures, review comments, and PR approvals
- [Custom Workflows](https://mintlify.wiki/ComposioHQ/agent-orchestrator/guides/custom-workflows.md): Build advanced automation with CI/CD integration, custom notification channels, and orchestrator-driven workflows
- [Managing Sessions](https://mintlify.wiki/ComposioHQ/agent-orchestrator/guides/managing-sessions.md): List active sessions, attach to terminals, send messages to agents, and clean up completed work
- [Multi-Project Setup](https://mintlify.wiki/ComposioHQ/agent-orchestrator/guides/multi-project.md): Configure and manage multiple repositories with different settings, trackers, and agents
- [Spawning Agents](https://mintlify.wiki/ComposioHQ/agent-orchestrator/guides/spawning-agents.md): Learn how to spawn AI coding agents for issues, configure custom prompts, and select different agent types
- [Installation](https://mintlify.wiki/ComposioHQ/agent-orchestrator/installation.md): Complete installation guide for Agent Orchestrator with prerequisites and configuration
- [Introduction](https://mintlify.wiki/ComposioHQ/agent-orchestrator/introduction.md): Learn about Agent Orchestrator, the orchestration layer for parallel AI coding agents
- [Aider Agent Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/agent/aider.md): Run Aider AI pair programming tool with git commit-based activity detection
- [Claude Code Agent Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/agent/claude-code.md): Run Anthropic's Claude Code CLI with automatic metadata tracking and session introspection
- [Codex Agent Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/agent/codex.md): Run OpenAI Codex CLI with PATH-based metadata wrappers and native thread resumption
- [OpenCode Agent Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/agent/opencode.md): Run OpenCode AI coding assistant (experimental support)
- [Creating Plugins](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/creating-plugins.md): Guide to developing custom plugins for Agent Orchestrator
- [Composio Notifier](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/notifier/composio.md): Unified notifications across Slack, Discord, and Gmail via Composio SDK
- [Desktop Notifier](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/notifier/desktop.md): OS-native desktop notifications for macOS and Linux
- [Slack Notifier](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/notifier/slack.md): Send rich notifications to Slack via incoming webhooks
- [Webhook Notifier](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/notifier/webhook.md): Send notifications to any HTTP endpoint with retry logic
- [Plugin Overview](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/overview.md): Understanding the Agent Orchestrator plugin architecture and available plugins
- [Process Runtime Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/runtime/process.md): Run agents as child processes with direct stdio control and minimal overhead
- [Tmux Runtime Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/runtime/tmux.md): Run agents in tmux sessions with full terminal control and session persistence
- [GitHub SCM Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/scm/github.md): Source control management plugin for GitHub PRs, CI checks, reviews, and merge readiness
- [iTerm2 Terminal](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/terminal/iterm2.md): macOS iTerm2 terminal tab management for agent sessions
- [Web Terminal](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/terminal/web.md): Browser-based xterm.js terminal for agent sessions
- [GitHub Tracker Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/tracker/github.md): Issue tracker plugin for GitHub Issues
- [Linear Tracker Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/tracker/linear.md): Issue tracker plugin for Linear
- [Clone Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/workspace/clone.md): Workspace plugin that creates fully independent git clones for complete isolation
- [Worktree Plugin](https://mintlify.wiki/ComposioHQ/agent-orchestrator/plugins/workspace/worktree.md): Workspace plugin that uses git worktrees for efficient workspace isolation
- [Quickstart](https://mintlify.wiki/ComposioHQ/agent-orchestrator/quickstart.md): Get Agent Orchestrator up and running in 5 minutes
- [Changelog](https://mintlify.wiki/ComposioHQ/agent-orchestrator/resources/changelog.md): Recent changes, releases, version history, and breaking changes for Agent Orchestrator
- [Contributing](https://mintlify.wiki/ComposioHQ/agent-orchestrator/resources/contributing.md): How to contribute to Agent Orchestrator - development setup, plugin development, and submission guidelines
- [Configuration Examples](https://mintlify.wiki/ComposioHQ/agent-orchestrator/resources/examples.md): Real-world configuration examples and use cases for Agent Orchestrator
- [Troubleshooting](https://mintlify.wiki/ComposioHQ/agent-orchestrator/resources/troubleshooting.md): Common issues, solutions, and debugging tips for Agent Orchestrator

## OpenAPI Specs

- [openapi](https://mintlify.wiki/ComposioHQ/agent-orchestrator/api-reference/openapi.json)