Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/coleam00/Archon/llms.txt

Use this file to discover all available pages before exploring further.

Archon is a workflow engine for AI coding agents. Define your development processes as YAML workflows — planning, implementation, validation, code review, PR creation — and run them reliably across all your projects. Like what Dockerfiles did for infrastructure, Archon does for AI coding workflows.

Quick Install

Get Archon running in 30 seconds with the standalone binary or 5 minutes with the full setup.

Core Concepts

Understand workflows, DAG nodes, isolation, and how Archon orchestrates AI agents.

Authoring Workflows

Create custom YAML workflows with parallel execution, loops, and approval gates.

CLI Reference

Full reference for every Archon command, flag, and subcommand.

​
Why Archon?

When you ask an AI agent to “fix this bug,” what happens depends on the model’s mood. It might skip planning, forget to run tests, or write a PR description that ignores your template. Every run is different. Archon fixes this. Encode your development process as a workflow. The workflow defines the phases, validation gates, and artifacts. The AI fills in the intelligence at each step, but the structure is deterministic and owned by you.

Repeatable

Same workflow, same sequence, every time. Plan, implement, validate, review, PR.

Isolated

Every workflow run gets its own git worktree. Run 5 fixes in parallel with no conflicts.

Fire and forget

Kick off a workflow, go do other work. Come back to a finished PR with review comments.

Composable

Mix bash scripts, tests, and git ops with AI planning and code generation nodes.

​
What a workflow looks like

Here’s an Archon workflow that plans, implements until tests pass, gets your approval, then creates the PR:
.archon/workflows/build-feature.yaml
nodes:
  - id: plan
    prompt: "Explore the codebase and create an implementation plan"

  - id: implement
    depends_on: [plan]
    loop:
      prompt: "Read the plan. Implement the next task. Run validation."
      until: ALL_TASKS_COMPLETE
      fresh_context: true

  - id: run-tests
    depends_on: [implement]
    bash: "bun run validate"

  - id: review
    depends_on: [run-tests]
    prompt: "Review all changes against the plan. Fix any issues."

  - id: approve
    depends_on: [review]
    loop:
      prompt: "Present the changes for review. Address any feedback."
      until: APPROVED
      interactive: true

  - id: create-pr
    depends_on: [approve]
    prompt: "Push changes and create a pull request"

​
Get started

1

Install Archon

Install the CLI binary or clone the repo for the full Web UI experience.
curl -fsSL https://archon.diy/install | bash
2

Run a workflow

Navigate to your git repository and kick off a built-in workflow.
cd /path/to/your/project
archon workflow run archon-assist "How does the auth module work?"
3

Customize

Copy a bundled workflow into .archon/workflows/ and tailor it to your team’s process.

​
Explore by topic

AI Assistants

Set up Claude, Codex, or Pi as your AI provider.

Loop Nodes

Build iterative workflows that run until a condition is met.

Platform Adapters

Connect Archon to Slack, Telegram, GitHub, or Discord.

Docker Deployment

Run Archon as an always-on service with Docker Compose.

Configuration Reference

All config options, environment variables, and YAML settings.

Workflow Schema

Complete YAML schema for every node type and workflow option.

Build docs developers (and LLMs) love

Get started for freeTalk to us