Installation

Quick Install

macOS / Linux

curl -fsSL https://archon.diy/install | bash

Windows (PowerShell)

irm https://archon.diy/install.ps1 | iex

Homebrew (macOS / Linux)

brew install coleam00/archon/archon

Docker

docker run --rm -v "$PWD:/workspace" ghcr.io/coleam00/archon:latest workflow list

From Source

git clone https://github.com/coleam00/Archon
cd Archon
bun install

Prerequisites (Source Install)

• Bun >= 1.0.0
• GitHub CLI (gh)
• Claude Code (claude)

Claude Code is required

Archon orchestrates Claude Code; it does not bundle it. Install Claude Code separately:

# macOS / Linux / WSL (Anthropic's recommended installer)
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

Source installs (bun run) find the executable automatically via node_modules. Compiled binaries (quick install, Homebrew) must point at the Claude Code executable:

# After the native installer:
export CLAUDE_BIN_PATH="$HOME/.local/bin/claude"

# After `npm install -g @anthropic-ai/claude-code`:
export CLAUDE_BIN_PATH="$(npm root -g)/@anthropic-ai/claude-code/cli.js"

Or set it durably in ~/.archon/config.yaml:

assistants:
  claude:
    claudeBinaryPath: /absolute/path/to/claude

Docker images (ghcr.io/coleam00/archon) ship with Claude Code pre-installed and CLAUDE_BIN_PATH pre-set — no configuration needed.

See AI Assistants → Claude Code for full details and install-layout paths.

Verify Installation

archon version

Next Steps

• Core Concepts — Understand workflows, nodes, commands, and isolation
• Quick Start — Run your first workflow
• Configuration — Set up API keys and preferences