explaingit

coleam00/archon

📈 Trending★ 21,612TypeScriptAudience · developerComplexity · 4/5ActiveLicenseSetup · moderate

TLDR

A workflow engine that lets you define AI-powered software development processes (planning, coding, testing, review) as YAML files and run them reliably with Claude Code.

Mindmap

mindmap
  root((Archon))
    What it does
      Define workflows as YAML
      Run AI coding steps
      Execute bash scripts
      Create pull requests
    Key features
      Isolated git branches
      Parallel task execution
      Human approval gates
      Version-controlled workflows
    How to trigger
      Command line
      Web dashboard
      Slack integration
      Telegram integration
    Tech stack
      TypeScript
      Bun runtime
      Claude Code
      GitHub CLI
    Use cases
      Automate code reviews
      Run testing pipelines
      Generate pull requests
      Parallel feature work

Things people build with this

USE CASE 1

Automate multi-step code review and testing workflows that run the same way every time without manual intervention.

USE CASE 2

Run parallel feature development tasks on isolated branches so multiple AI agents can work simultaneously without conflicts.

USE CASE 3

Create pull requests automatically after planning, coding, and testing steps complete with human approval checkpoints.

USE CASE 4

Define reusable software development processes as version-controlled YAML files that teams can share and modify.

Tech stack

TypeScriptBunClaude CodeGitHub CLIYAML

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Claude API key and GitHub CLI authentication to run workflows.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

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.

Copy-paste prompts

Prompt 1
Set up an Archon workflow that plans a feature, writes the code, runs tests, and creates a pull request automatically.
Prompt 2
Create a YAML workflow file that runs my test suite, checks for linting errors, and pauses for human review before merging.
Prompt 3
How do I trigger an Archon workflow from Slack to add a new API endpoint to my project?
Prompt 4
Configure Archon to run multiple feature branches in parallel using isolated git worktrees so they don't interfere with each other.
Prompt 5
Write a workflow that uses Claude Code to refactor a specific module, then automatically opens a pull request with the changes.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.