Archon
by coleam00
Archon is a self-hosted workflow engine that lets you describe a process in YAML and run it with AI coding agents such as Claude Code and Codex, plus scripts and human approval steps. It is mainly used to make AI-assisted software work follow the same steps each time, from issue to merged pull request.
- Stars
- 23.8k +2 a day
- Licence
- MIT
- Runs on
- Your computer
- Setup
- Technical
- Language
- TypeScript
- Age
- 629 days
What you can do with it
- Write a YAML workflow that plans, implements until tests pass, asks for your approval, then opens a pull request
- Run the bundled software pack to take GitHub issues through review and merge with queues
- Build non-code workflows such as content production, research or support with agent, script and approval steps
Make money with it
A freelance developer could offer fixed-price maintenance or feature delivery to clients, using Archon workflows to produce consistent, reviewed pull requests faster.
An idea, not financial advice. Check the licence before charging for anything built on it.
Ways a business could use it
- Automate routine bug fixes and feature work in a product's repository with consistent plan, test and review steps, which cuts supervision time
- Run repeatable internal processes such as content drafts or research with approval gates, so one person can oversee more work
Can you use it commercially?
Free to use, change and sell, including in paid products. Keep the copyright notice.
Not legal advice. Read the project's licence file before building a product on it.
Getting it running
You install it on your machine or server (it uses Bun and SQLite by default), after installing an agent CLI such as Claude Code; the quickstart is cut off in the README provided.
Follow the official instructions in the project README.
Things to check
- Needs your own paid subscriptions or API access to Claude Code, Codex or similar agents
- Agents can change code and open or merge pull requests, so approval gates and permissions need careful setup
- The bundled software pack currently depends on the GitHub CLI
- Setup is technical and the README excerpt was cut off before the install steps
Checked 30 Oct 2026. Summary drafted by AI from the project's README.