Skip to content
Archon Archon

Installation

Quick Install

Section titled “Quick Install”

macOS / Linux

Section titled “macOS / Linux”
Terminal window
curl -fsSL https://archon.diy/install | bash

x64 compatibility: Compiled x64 binaries require AVX2. Older Intel/AMD hardware and virtual machines that mask AVX2 cannot use the x64 quick install; use From Source instead. ARM64 quick installs are unaffected.

Windows (PowerShell)

Section titled “Windows (PowerShell)”
Terminal window
irm https://archon.diy/install.ps1 | iex

Homebrew (macOS / Linux)

Section titled “Homebrew (macOS / Linux)”
Terminal window
brew install coleam00/archon/archon

Docker

Section titled “Docker”
Terminal window
docker run --rm -v "$PWD:/workspace" ghcr.io/coleam00/archon:latest workflow list

Using Archon from a GUI or service

Section titled “Using Archon from a GUI or service”

The quick installer and Homebrew install a native, compiled archon executable; they do not require Bun at runtime. Each compiled invocation records its absolute path and version in <ARCHON_HOME>/install.json:

{
  "binary": "/usr/local/bin/archon",
  "version": "0.9.0"
}

Treat this file as a discovery hint, not executable configuration. An explicit path configured by the user always wins. Otherwise, read the manifest, require binary to be an absolute executable path, and launch it directly. If the file is absent or invalid, fall back to the documented platform default or ask the user to choose a binary. The quick-installer defaults are /usr/local/bin/archon on macOS/Linux and %USERPROFILE%\.archon\bin\archon.exe on Windows; expand %USERPROFILE% to the user’s home directory before invoking the Windows path.

The last compiled Archon invoked updates the record when its path or version changes. Quick installers create it during their final version check. Homebrew creates it on first use. Source and Bun-linked invocations never write it.

The source-install and bun link workflow is for terminal development and requires Bun on PATH.

From Source

Section titled “From Source”
Terminal window
git clone https://github.com/coleam00/Archon
cd Archon
bun install

Prerequisites (Source Install)

Section titled “Prerequisites (Source Install)”

Claude Code is required

Section titled “Claude Code is required”

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

Terminal window
# 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:

Terminal window
# 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

Section titled “Verify Installation”
Terminal window
archon version

Next Steps

Section titled “Next Steps”