Archon

Archon is a workflow engine for AI coding agents built in TypeScript. It lets developers define their software development process — planning, coding, testing, code review, and pull request creation — as structured YAML workflow files, then run those steps reliably using an AI assistant like Claude Code. The key idea is that instead of asking an AI to "fix this bug" and getting unpredictable results each time, you encode your exact process as a workflow that the AI follows the same way every run.

Each workflow run gets its own isolated git branch (called a worktree), so multiple tasks can run in parallel without interfering with each other. Workflows support both deterministic steps — like running a bash script or executing tests — and AI-powered steps like planning or writing code. Human approval gates can be inserted at any point, pausing the workflow until a person reviews and signs off. Once set up, a developer can say something like "use archon to add dark mode to the settings page" and come back later to find a finished pull request.

Archon can be triggered from a command-line interface, a web dashboard, or messaging platforms like Slack and Telegram. Workflows are stored as plain YAML files in a .archon/workflows/ folder inside each project repository, making them portable and version-controlled. The project requires Bun, Claude Code, and the GitHub CLI to run.