Archon

Active
GitHub TypeScript MIT

Description

The first open-source harness builder for AI coding — defines development workflows as YAML (planning, implementation, validation, code review, PR creation) and runs them reliably across projects, like Dockerfiles for AI coding.

Key Features

  • YAML workflow engine — declaratively define planning, implementation, validation, review, and PR phases
  • Isolated execution — every run gets its own git worktree so 5 fixes can run in parallel without conflicts
  • Deterministic + AI node hybrid — mix bash scripts and tests with AI nodes freely
  • Loop and fail conditions — AI nodes can specify until conditions to iterate until tasks complete
  • Human approval gates — interactive nodes pause and wait for human input before continuing
  • Portable — the same .archon/workflows runs identically from CLI, Web UI, Slack, Telegram, and GitHub

Use Cases

💡 Codifying AI coding into repeatable workflows so results don't vary between runs
💡 Triggering multiple bug fixes or feature PRs in parallel without conflicts
💡 Committing .archon/workflows to the repo so the whole team reuses the same flow
💡 Automating PR creation and code review, integrated with Slack or GitHub
💡 Enforcing plan -> implement -> validate flows when working with Claude Code or Cursor

Quick Start

git clone https://github.com/coleam00/Archon.git
cd Archon
bun install
bun run dev
# Visit http://localhost:5173 and define your first .archon/workflows/*.yaml

Related Projects