Archon runs AI coding agents through development processes you define as YAML workflows — planning, implementation, validation, code review, and pull-request creation — so the same sequence of phases, validation gates, and artifacts repeats on every run. Every workflow run gets its own git worktree, so several can run at once without conflicts.
A workflow is a directed graph of nodes. Deterministic nodes run bash commands, tests, or git operations; AI nodes handle planning, code generation, and review; loop nodes repeat until a condition such as ALLTASKSCOMPLETE is met, optionally with a fresh session each iteration; and interactive loop nodes pause for human approval before continuing. Workflow definitions live in .archon/workflows/ inside your repository, and same-named files there override the bundled ones.
Nineteen workflows ship by default, covering GitHub issue fixes, idea-to-PR feature development, plan execution, multi-agent PR review, PRD creation, refactoring, and merge-conflict resolution. You describe what you want and a router picks the workflow, or you invoke one by name from the CLI.
A web dashboard adds chat with streaming and tool-call display, a mission-control view of running and past workflows filterable by project, status, and date, a drag-and-drop workflow builder, and a step-by-step execution view. The sidebar collects conversations from every adapter, so CLI runs, Slack or Telegram messages, and GitHub issue interactions appear in one place. State is stored in SQLite or PostgreSQL across 14 core tables.
Beyond the web interface and CLI, chat adapters connect Telegram, Slack, Discord, and GitHub webhooks. Archon sends anonymous, categorical telemetry — workflow name for bundled workflows, run shape and outcome, aggregate token and cost totals, machine context — and never code, prompts, messages, custom workflow names, or error text. Set ARCHONTELEMETRYDISABLED=1, DONOTTRACK=1, or POSTHOGAPIKEY=off to opt out; continuous-integration environments are disabled automatically.
Features
- YAML workflows: phases, dependencies, validation gates, and artifacts declared in a file you commit with the code
- Worktree isolation: each run works in its own git worktree, so parallel runs do not collide
- Mixed nodes: deterministic bash, test, and git steps alongside AI planning, generation, and review steps
- Loops and approval gates: iterate until a condition holds, or pause for a human decision mid-run
- Bundled workflow library: 19 workflows for issue fixes, feature development, PR review, PRDs, and refactoring
- Workflow router: describe the task in natural language and Archon selects the workflow
- Web dashboard: chat, run monitoring, a visual workflow builder, and per-node execution progress
- Chat adapters: Telegram, Slack, Discord, and GitHub webhooks feed the same orchestrator as the CLI and web interface
- Storage options: SQLite or PostgreSQL, with multi-user mode and web authentication on Postgres
- Opt-out telemetry: categorical events only, disabled by environment variable or in CI
