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. A GUI app, launchd job, or other process without your login-shell PATH should launch that executable by an absolute path, configured by the user (the quick-installer defaults are /usr/local/bin/archon on macOS/Linux and %USERPROFILE%\\.archon\\bin\\archon.exe on Windows). Do not invoke the Bun-linked/source CLI from these processes.

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”