Archon is a workflow engine for AI coding agents. You encode a development process (planning, implementation, validation, code review, pull request creation) as a YAML workflow, and Archon runs it the same way every time. The workflow fixes the phases, validation gates, and artifacts, and the coding agent fills in the work at each AI step.
A workflow is a multi-step DAG of nodes. Deterministic nodes run bash scripts, tests, and git operations, and AI nodes handle planning, code generation, and review. Nodes can loop until a condition holds (for example, until all tasks are complete or tests pass), start each iteration with a fresh context, and pause at interactive approval gates for human input. Every run gets its own git worktree, so several workflows can run in parallel on one repository without conflicts.
Workflows live in the repository and run the same way from the CLI, the web UI, Telegram, Slack, Discord, or GitHub webhooks. An orchestrator routes messages and context to a command handler, the YAML workflow executor, and AI assistant clients for Claude Code, Codex, and Pi, with state in SQLite or PostgreSQL. Archon ships 19 default workflows (issue fixing, idea to pull request, multi-agent pull request review, safe refactoring, merge conflict resolution, a workflow builder, and others), and a router picks one from a plain-language request. Repository workflows with the same name override the bundled ones.
This is a rewrite: the earlier Python-based Archon (task management and RAG) is preserved on an archive branch.
Features
- YAML workflows: development processes defined as DAGs of nodes and committed to the repository
- Mixed nodes: deterministic bash, test, and git nodes alongside AI nodes for planning, coding, and review
- Loops and gates: nodes repeat until a condition holds, optionally with fresh context per iteration, and approval gates wait for human input
- Worktree isolation: each run gets its own git worktree, so parallel runs never collide
- Bundled workflows: 19 defaults covering issue fixing, idea to pull request, pull request review, refactoring, PRDs, and conflict resolution
- Workflow router: picks the right workflow from a plain-language request
- Platform adapters: CLI, web UI, Telegram, Slack, Discord, and GitHub webhooks
- Assistant clients: Claude Code, Codex, and Pi, switchable per workflow or per node
- Persistent state: conversations, sessions, workflow runs, and events stored in SQLite or PostgreSQL
- Workflow builder: a bundled workflow that generates new workflow YAML for a project
- Opt-out telemetry: anonymous categorical usage events with no code, prompts, or messages
