Archon CLI
Archon is an agent-workflow system that pauses a task for a human decision and records the answer before work continues.
- 23,899 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Archon runs agents and commands that can push code and merge changes using configured provider and GitHub CLI access.
Install
- Works in
Manual install
curl -fsSL https://archon.diy/install | bashFirst macOS/Linux Quickstart option. Inspect the script and configure a provider separately.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Archon runs agents and commands that can push code and merge changes using configured provider and GitHub CLI access.
This is third-party code. Review the repository files before installing.
What it does
Archon executes YAML workflows through Claude Code, Codex or Pi. A workflow author defines agent steps, commands and validation loops. The development pack takes an issue from analysis to a pull request with review and CI checks. Run state, events and costs are stored in its own database. Repository tasks use separate Git worktrees by default. Build and merge queues are included, but their schedules and event triggers need separate configuration. YAML workflows can also cover non-coding tasks.
Who it is for. Teams running repeatable agent development with validation, queues and explicit owner decisions.
Good fit when
- A task follows a defined sequence of planning, coding and review.
- After tests, the workflow waits for the owner before publishing changes.
- Several tasks run in separate Git worktrees.
- The team investigates a stopped run using its event log and saved state.
Not a fit when
- Agents cannot execute repository commands.
- A merge queue would be enabled without reviewing permissions and branch rules.
- You need the earlier Python Archon for RAG and task management.
Example request
Design a bug-fix YAML workflow with tests and mandatory human approval before push, without automatic merging.Limitations
Agent providers must be installed and authenticated separately; Archon uses their access rather than replacing accounts. Workflow commands and scripts can edit files, push branches and merge, so review the entire YAML first. Included development queues have no schedule bindings by default; configure triggers separately. Anonymous telemetry is enabled in ordinary environments, with opt-out environment variables and a command to inspect its current state.
How to disable. Stop queues and active runs as documented, then disable associated triggers. Preserve needed run databases and logs.
FAQ
Is Archon a model?
No. Install and authenticate the chosen CLI first: Claude Code, Codex or Pi. Archon invokes it as a provider; see the [installation guide](https://archon.diy/getting-started/installation/).
Where do I see pending run decisions?
Use `archon workflow attention` or the `archon serve` web console.
Do queues start automatically after installation?
No. Start a queue manually or bind it to a schedule or issue event using the [trigger guide](https://archon.diy/guides/workflow-triggers/). The development pack creates no bindings by default.
Where is the old RAG version?
On `archive/v1-task-management-rag`. Do not mix its instructions with the current product.
How do I check telemetry?
Run `archon telemetry status`. To opt out, set `ARCHON_TELEMETRY_DISABLED=1` in Archon’s launch environment, then inspect the status again.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI and plugin: agent workflows live in the repository as Markdown and YAML with roles, scripts, pauses and branching.
An orchestrator for agents: the workflow is defined in code, every step is enforced, key points need human approval and decisions go into an immutable journal
Shared infrastructure for Claude Code, Codex, Antigravity CLI and OpenCode: a task lifecycle, skills and sandboxes.
One agent launches others in the background: Claude Code, Codex, Copilot CLI, Grok Build and Pi, with a model chosen per stage.
A local daemon assembles Claude Code, Codex and OpenCode into a team: tasks, separate worktrees, checks and merging.
A bridge between local CLI agents: Codex, Cursor or Claude Code delegate work to Antigravity, Grok, Kimi and seven more.
README in short
SQLite is the default, with PostgreSQL available. Plugins add workflow packs, providers and integrations.