# Archon

> An open-source workflow engine for AI coding agents that makes development processes deterministic and repeatable using YAML-defined workflows.

Archon is an open-source workflow engine for AI coding agents that lets you define your development processes as YAML workflows — planning, implementation, validation, code review, and PR creation — and run them reliably across all your projects. Like what Dockerfiles did for infrastructure and GitHub Actions did for CI/CD, Archon brings structure and repeatability to AI-assisted software development. It ships with 17 built-in workflows and supports custom workflows, making AI coding deterministic rather than dependent on model behavior.

- **YAML Workflow Definitions** — *Define development phases, validation gates, and artifacts in `.archon/workflows/` YAML files committed to your repo so the whole team runs the same process.*
- **Isolated Git Worktrees** — *Every workflow run gets its own git worktree, enabling 5+ parallel fixes with no conflicts.*
- **Composable Nodes** — *Mix deterministic nodes (bash scripts, tests, git ops) with AI nodes (planning, code generation, review) so AI only runs where it adds value.*
- **Human-in-the-Loop Gates** — *Interactive loop nodes pause and wait for human approval before proceeding to the next phase.*
- **17 Built-in Workflows** — *Includes `archon-fix-github-issue`, `archon-idea-to-pr`, `archon-smart-pr-review`, `archon-refactor-safely`, and more out of the box.*
- **Web Dashboard** — *A full web UI with chat interface, real-time workflow monitoring, drag-and-drop workflow builder, and unified inbox for all platform messages.*
- **Multi-Platform Adapters** — *Connect via CLI, Web UI, Slack, Telegram, Discord, or GitHub Webhooks; all conversations appear in one monitoring hub.*
- **Fire-and-Forget Execution** — *Kick off a workflow, go do other work, and come back to a finished PR with review comments.*
- **SQLite / PostgreSQL Backend** — *Stores codebases, conversations, sessions, workflow runs, isolation environments, messages, and workflow events across 7 tables.*
- **Quick Install** — *Install via `curl -fsSL https://archon.diy/install | bash` (macOS/Linux), PowerShell script (Windows), or Homebrew; full setup wizard available via `bun install` + Claude Code.*

## Features
- YAML workflow definitions
- Isolated git worktrees per run
- Composable deterministic and AI nodes
- Human-in-the-loop approval gates
- 17 built-in workflows
- Web dashboard with real-time monitoring
- Drag-and-drop workflow builder
- Multi-platform adapters (CLI, Web, Slack, Telegram, Discord, GitHub)
- Fire-and-forget workflow execution
- SQLite and PostgreSQL backend
- Custom workflow authoring
- Parallel workflow execution
- Automated PR creation and review
- Loop nodes with iteration until completion

## Integrations
Claude Code, GitHub, Slack, Telegram, Discord, GitHub Webhooks, Bun, SQLite, PostgreSQL, Docker

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v0.3.2

## Links
- Website: https://archon.diy
- Documentation: https://archon.diy/getting-started/overview/
- Repository: https://github.com/coleam00/Archon
- EveryDev.ai: https://www.everydev.ai/tools/archon