{"id":4146,"date":"2026-08-18T15:28:17","date_gmt":"2026-08-18T07:28:17","guid":{"rendered":"https:\/\/ai.wuaishare.cn\/hub\/?p=4146"},"modified":"2026-08-18T15:28:17","modified_gmt":"2026-08-18T07:28:17","slug":"archon","status":"publish","type":"post","link":"https:\/\/ai.wuaishare.cn\/hub\/en\/4146","title":{"rendered":"Archon"},"content":{"rendered":"

\n \"Archon\"\n<\/p>\n

Archon<\/h1>\n

\n The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.\n<\/p>\n

\n \"coleam00%2FArchon<\/a>\n<\/p>\n

\n \"License:<\/a>
\n \"CI\"<\/a>
\n \"Docs\"<\/a>\n<\/p>\n

—<\/p>\n

Archon is a workflow engine for AI coding agents. Define your development processes as YAML workflows – planning, implementation, validation, code review, PR creation – and run them reliably across all your projects.<\/p>\n

Like what Dockerfiles did for infrastructure and GitHub Actions did for CI\/CD – Archon does for AI coding workflows. Think n8n, but for software development.<\/p>\n

## Why Archon?<\/p>\n

When you ask an AI agent to “fix this bug”, what happens depends on the model’s mood. It might skip planning. It might forget to run tests. It might write a PR description that ignores your template. Every run is different.<\/p>\n

Archon fixes this. Encode your development process as a workflow. The workflow defines the phases, validation gates, and artifacts. The AI fills in the intelligence at each step, but the structure is deterministic and owned by you.<\/p>\n

– **Repeatable** – Same workflow, same sequence, every time. Plan, implement, validate, review, PR.
\n– **Isolated** – Every workflow run gets its own git worktree. Run 5 fixes in parallel with no conflicts.
\n– **Fire and forget** – Kick off a workflow, go do other work. Come back to a finished PR with review comments.
\n– **Composable** – Mix deterministic nodes (bash scripts, tests, git ops) with AI nodes (planning, code generation, review). The AI only runs where it adds value.
\n– **Portable** – Define workflows once in `.archon\/workflows\/`, commit them to your repo. They work the same from CLI, Web UI, Slack, Telegram, or GitHub.<\/p>\n

## What It Looks Like<\/p>\n

Here’s an example of an Archon workflow that plans, implements in a loop until tests pass, gets your approval, then creates the PR:<\/p>\n

“`yaml
\n# .archon\/workflows\/build-feature.yaml
\nnodes:
\n – id: plan
\n prompt: “Explore the codebase and create an implementation plan”<\/p>\n

– id: implement
\n depends_on: [plan]
\n loop: # AI loop – iterate until done
\n prompt: “Read the plan. Implement the next task. Run validation.”
\n until: ALL_TASKS_COMPLETE
\n fresh_context: true # Fresh session each iteration<\/p>\n

– id: run-tests
\n depends_on: [implement]
\n bash: “bun run validate” # Deterministic – no AI<\/p>\n

– id: review
\n depends_on: [run-tests]
\n prompt: “Review all changes against the plan. Fix any issues.”<\/p>\n

– id: approve
\n depends_on: [review]
\n loop: # Human approval gate
\n prompt: “Present the changes for review. Address any feedback.”
\n until: APPROVED
\n interactive: true # Pauses and waits for human input<\/p>\n

– id: create-pr
\n depends_on: [approve]
\n prompt: “Push changes and create a pull request”
\n“`<\/p>\n

Tell your coding agent what you want, and Archon handles the rest:<\/p>\n

“`
\nYou: Use archon to add dark mode to the settings page<\/p>\n

Agent: I’ll run the archon-idea-to-pr workflow for this.
\n \u2192 Creating isolated worktree on branch archon\/task-dark-mode…
\n \u2192 Planning…
\n \u2192 Implementing (task 1\/4)…
\n \u2192 Implementing (task 2\/4)…
\n \u2192 Tests failing – iterating…
\n \u2192 Tests passing after 2 iterations
\n \u2192 Code review complete – 0 issues
\n \u2192 PR ready: https:\/\/github.com\/you\/project\/pull\/47
\n“`<\/p>\n

## Previous Version<\/p>\n

Looking for the original Python-based Archon (task management + RAG)? It’s fully preserved on the [`archive\/v1-task-management-rag`](https:\/\/github.com\/coleam00\/Archon\/tree\/archive\/v1-task-management-rag) branch.<\/p>\n

## Getting Started<\/p>\n

> **Most users should start with the [Full Setup](#full-setup-5-minutes)** – it walks you through credentials, installs the Archon skill into your projects, and gives you the web dashboard.
\n>
\n> **Already have Claude Code and just want the CLI?** Jump to the [Quick Install](#quick-install-30-seconds).<\/p>\n

### Full Setup (5 minutes)<\/p>\n

Clone the repo and use the guided setup wizard. This configures credentials, platform integrations, and copies the Archon skill into your target projects.<\/p>\n

\nPrerequisites<\/b> – Bun, Claude Code, and the GitHub CLI<\/summary>\n

**Bun** – [bun.sh](https:\/\/bun.sh)<\/p>\n

“`bash
\n# macOS\/Linux
\ncurl -fsSL https:\/\/bun.sh\/install | bash<\/p>\n

# Windows (PowerShell)
\nirm bun.sh\/install.ps1 | iex
\n“`<\/p>\n

**GitHub CLI** – [cli.github.com](https:\/\/cli.github.com\/)<\/p>\n

“`bash
\n# macOS
\nbrew install gh<\/p>\n

# Windows (via winget)
\nwinget install GitHub.cli<\/p>\n

# Linux (Debian\/Ubuntu)
\nsudo apt install gh
\n“`<\/p>\n

**Claude Code** – [claude.ai\/code](https:\/\/claude.ai\/code)<\/p>\n

“`bash
\n# macOS\/Linux\/WSL
\ncurl -fsSL https:\/\/claude.ai\/install.sh | bash<\/p>\n

# Windows (PowerShell)
\nirm https:\/\/claude.ai\/install.ps1 | iex
\n“`<\/p>\n<\/details>\n

“`bash
\ngit clone https:\/\/github.com\/coleam00\/Archon
\ncd Archon
\nbun install
\nclaude
\n“`<\/p>\n

Then say: **”Set up Archon”**<\/p>\n

The setup wizard walks you through everything: CLI installation, authentication, platform selection, and copies the Archon skill to your target repo.<\/p>\n

### Quick Install (30 seconds)<\/p>\n

Already have Claude Code set up? Install the standalone CLI binary and skip the wizard.<\/p>\n

**macOS \/ Linux**
\n“`bash
\ncurl -fsSL https:\/\/archon.diy\/install | bash
\n“`<\/p>\n

> **x64 compatibility:** The macOS\/Linux quick install requires AVX2 on x64
\n> CPUs. Older Intel\/AMD hardware and virtual machines that mask AVX2 should use
\n> the [source installation guide](https:\/\/archon.diy\/getting-started\/installation\/#from-source).
\n> ARM64 quick installs are unaffected.<\/p>\n

**Windows (PowerShell)**
\n“`powershell
\nirm https:\/\/archon.diy\/install.ps1 | iex
\n“`<\/p>\n

**Homebrew**
\n“`bash
\nbrew install coleam00\/archon\/archon
\n“`<\/p>\n

> **Compiled binaries need a `CLAUDE_BIN_PATH`.** The quick-install binaries
\n> don’t bundle Claude Code. Install it separately, then point Archon at it:
\n>
\n> “`bash
\n> # macOS \/ Linux \/ WSL
\n> curl -fsSL https:\/\/claude.ai\/install.sh | bash
\n> export CLAUDE_BIN_PATH=”$HOME\/.local\/bin\/claude”
\n>
\n> # Windows (PowerShell)
\n> irm https:\/\/claude.ai\/install.ps1 | iex
\n> $env:CLAUDE_BIN_PATH = “$env:USERPROFILE\\.local\\bin\\claude.exe”
\n> “`
\n>
\n> Or set `assistants.claude.claudeBinaryPath` in `~\/.archon\/config.yaml`.
\n> The Docker image ships Claude Code pre-installed. See [AI Assistants \u2192 Binary path configuration](https:\/\/archon.diy\/getting-started\/ai-assistants\/#binary-path-configuration-compiled-binaries-only) for details.<\/p>\n

### Start Using Archon<\/p>\n

Once you’ve completed either setup path, go to your project and start working:<\/p>\n

“`bash
\ncd \/path\/to\/your\/project
\nclaude
\n“`<\/p>\n

“`
\nUse archon to fix issue #42
\n“`<\/p>\n

“`
\nWhat archon workflows do I have? When would I use each one?
\n“`<\/p>\n

The coding agent handles workflow selection, branch naming, and worktree isolation for you. Projects are registered automatically the first time they’re used.<\/p>\n

> **Important:** Always run Claude Code from your target repo, not from the Archon repo. The setup wizard copies the Archon skill into your project so it works from there.<\/p>\n

## Web UI<\/p>\n

Archon includes a web dashboard for chatting with your coding agent, running workflows, and monitoring activity. Binary installs: run `archon serve` to download and start the web UI in one step. From source: ask your coding agent to run the frontend from the Archon repo, or run `bun run dev` from the repo root yourself.<\/p>\n

Register a project by clicking **+** next to “Project” in the chat sidebar – enter a GitHub URL or local path. Then start a conversation, invoke workflows, and watch progress in real time.<\/p>\n

**Key pages:**
\n– **Chat** – Conversation interface with real-time streaming and tool call visualization
\n– **Dashboard** – Mission Control for monitoring running workflows, with filterable history by project, status, and date
\n– **Workflow Builder** – Visual drag-and-drop editor for creating DAG workflows with loop nodes
\n– **Workflow Execution** – Step-by-step progress view for any running or completed workflow<\/p>\n

**Monitoring hub:** The sidebar shows conversations from **all platforms** – not just the web. Workflows kicked off from the CLI, messages from Slack or Telegram, GitHub issue interactions – everything appears in one place.<\/p>\n

See the [Web UI Guide](https:\/\/archon.diy\/adapters\/web\/) for full documentation.<\/p>\n

## What Can You Automate?<\/p>\n

Archon ships with workflows for common development tasks:<\/p>\n

| Workflow | What it does |
\n|———-|————-|
\n| `archon-assist` | General Q&A, debugging, exploration – full Claude Code agent with all tools |
\n| `archon-fix-github-issue` | Classify issue \u2192 investigate\/plan \u2192 implement \u2192 validate \u2192 PR \u2192 smart review \u2192 self-fix |
\n| `archon-create-issue` | Classify problem \u2192 gather context \u2192 investigate \u2192 create GitHub issue |
\n| `archon-issue-review-full` | Comprehensive fix + full multi-agent review pipeline for GitHub issues |
\n| `archon-piv-loop` | Guided Plan-Implement-Validate loop with human review between iterations |
\n| `archon-idea-to-pr` | Feature idea \u2192 plan \u2192 implement \u2192 validate \u2192 PR \u2192 5 parallel reviews \u2192 self-fix |
\n| `archon-plan-to-pr` | Execute existing plan \u2192 implement \u2192 validate \u2192 PR \u2192 review \u2192 self-fix |
\n| `archon-feature-development` | Implement feature from plan \u2192 validate \u2192 create PR |
\n| `archon-adversarial-dev` | Build a complete application from scratch using adversarial development |
\n| `archon-smart-pr-review` | Classify PR complexity \u2192 run targeted review agents \u2192 synthesize findings |
\n| `archon-comprehensive-pr-review` | Multi-agent PR review (5 parallel reviewers) with automatic fixes |
\n| `archon-validate-pr` | Thorough PR validation testing both main and feature branches |
\n| `archon-architect` | Architectural sweep, complexity reduction, codebase health improvement |
\n| `archon-refactor-safely` | Safe refactoring with type-check hooks and behavior verification |
\n| `archon-interactive-prd` | Create a PRD through guided conversation |
\n| `archon-ralph-dag` | PRD implementation loop – iterate through stories until done |
\n| `archon-workflow-builder` | Generate a new Archon workflow YAML for your project |
\n| `archon-remotion-generate` | Generate or modify Remotion video compositions with AI |
\n| `archon-resolve-conflicts` | Detect merge conflicts \u2192 analyze both sides \u2192 resolve \u2192 validate \u2192 commit |<\/p>\n

Archon ships 19 default workflows – run `archon workflow list` or describe what you want and the router picks the right one.<\/p>\n

**Or define your own.** Keep a workflow copyable by placing its YAML, commands, and scripts together under `.archon\/workflows\/\/\/`; both directory names are yours. The same tree works in target repos and under `~\/.archon\/workflows\/`. Existing flat workflows and shared `.archon\/commands\/` \/ `.archon\/scripts\/` remain supported. Same-named workflow files in your repo override bundled defaults.<\/p>\n

See [Authoring Workflows](https:\/\/archon.diy\/guides\/authoring-workflows\/) and [Authoring Commands](https:\/\/archon.diy\/guides\/authoring-commands\/).<\/p>\n

## Add a Platform<\/p>\n

The Web UI and CLI work out of the box. Optionally connect a chat platform for remote access:<\/p>\n

| Platform | Setup time | Guide |
\n|———-|———–|——-|
\n| **Telegram** | 5 min | [Telegram Guide](https:\/\/archon.diy\/adapters\/telegram\/) |
\n| **Slack** | 15 min | [Slack Guide](https:\/\/archon.diy\/adapters\/slack\/) |
\n| **GitHub Webhooks** | 15 min | [GitHub Guide](https:\/\/archon.diy\/adapters\/github\/) |
\n| **Discord** | 5 min | [Discord Guide](https:\/\/archon.diy\/adapters\/community\/discord\/) |<\/p>\n

## Architecture<\/p>\n

“`
\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n\u2502 Platform Adapters (Web UI, CLI, Telegram, Slack, \u2502
\n\u2502 Discord, GitHub) \u2502
\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
\n \u2502
\n \u25bc
\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n\u2502 Orchestrator \u2502
\n\u2502 (Message Routing & Context Management) \u2502
\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
\n \u2502 \u2502
\n \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n \u2502 \u2502 \u2502 \u2502
\n \u25bc \u25bc \u25bc \u25bc
\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n\u2502 Command \u2502 \u2502 Workflow \u2502 \u2502 AI Assistant Clients \u2502
\n\u2502 Handler \u2502 \u2502 Executor \u2502 \u2502 (Claude \/ Codex \/ Pi) \u2502
\n\u2502 (Slash) \u2502 \u2502 (YAML) \u2502 \u2502 \u2502
\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
\n \u2502 \u2502 \u2502
\n \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
\n \u2502
\n \u25bc
\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n\u2502 SQLite \/ PostgreSQL (14 core tables) \u2502
\n\u2502 Codebases \u2022 Conversations \u2022 Sessions \u2022 Workflow Runs \u2502
\n\u2502 Isolation Environments \u2022 Messages \u2022 Workflow Events \u2502
\n\u2502 Users \u2022 User Identities \u2022 Workflow Node Sessions \u2502
\n\u2502 Codebase Env Vars \u2022 User GitHub Tokens \u2502
\n\u2502 User Provider Keys \u2022 User AI Prefs \u2502
\n\u2502 (+ Better Auth tables, Postgres only) \u2502
\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
\n“`<\/p>\n

## Documentation<\/p>\n

Full documentation is available at **[archon.diy\/docs](https:\/\/archon.diy\/docs\/)**.<\/p>\n

| Topic | Description |
\n|——-|————-|
\n| [Getting Started](https:\/\/archon.diy\/getting-started\/overview\/) | Setup guide (Web UI or CLI) |
\n| [The Book of Archon](https:\/\/archon.diy\/book\/) | 10-chapter narrative tutorial |
\n| [CLI Reference](https:\/\/archon.diy\/reference\/cli\/) | Full CLI reference |
\n| [Authoring Workflows](https:\/\/archon.diy\/guides\/authoring-workflows\/) | Create custom YAML workflows |
\n| [Authoring Commands](https:\/\/archon.diy\/guides\/authoring-commands\/) | Create reusable AI commands |
\n| [Configuration](https:\/\/archon.diy\/reference\/configuration\/) | All config options, env vars, YAML settings |
\n| [AI Assistants](https:\/\/archon.diy\/getting-started\/ai-assistants\/) | Claude, Codex, and Pi setup details |
\n| [Deployment](https:\/\/archon.diy\/deployment\/) | Docker, VPS, production setup |
\n| [Architecture](https:\/\/archon.diy\/reference\/architecture\/) | System design and internals |
\n| [Troubleshooting](https:\/\/archon.diy\/reference\/troubleshooting\/) | Common issues and fixes |<\/p>\n

**For AI tools:** Point your LLM at [`\/llms.txt`](https:\/\/archon.diy\/llms.txt) for an index of all documentation, [`\/llms-full.txt`](https:\/\/archon.diy\/llms-full.txt) for the complete docs in a single file, or [`\/llms-small.txt`](https:\/\/archon.diy\/llms-small.txt) for a condensed version.<\/p>\n

## Telemetry<\/p>\n

Archon sends a few anonymous events so maintainers can see which workflows get real usage, on what platforms, and whether runs succeed \u2014 and prioritize accordingly. **No PII, ever.** Events: `archon_started` (once per CLI invocation \/ server boot), `archon_active` (daily heartbeat while a server is running, so long-running installs stay counted), `chat_turn_handled` (each direct AI chat turn \u2014 platform, provider, model, duration, and usage totals; never message content), `workflow_invoked` (each workflow start), `workflow_completed` \/ `workflow_failed` (each run outcome), `workflow_approval_resolved` (each human approve\/reject decision \u2014 the binary resolution only, never comments or reasons), and `codebase_registered` (a pure count when a project is registered \u2014 no name, path, or URL).<\/p>\n

**What’s collected (categorical only):**
\n– **Workflow name** \u2014 the real name for *bundled* (Archon-authored) workflows; `”custom”` for your own workflows, so private names never leave your machine.
\n– **Run shape & outcome** \u2014 platform (`cli`\/`web`\/`slack`\/\u2026), provider id (plus the model id on `workflow_invoked`), node count, which node types and features are used (loop\/approval\/script\/bash, structured output, persisted sessions, MCP, skills, fresh-context loops), success\/failure, duration, a categorical failure reason, and a fixed-enum failure class (`fatal`\/`transient`\/`unknown` \u2014 never raw error text) plus the failed node’s type.
\n– **Chat activity** \u2014 one event per direct-chat AI turn with platform, provider, model, duration, and completed\/failed. Message content, prompts, and conversation ids are never sent.
\n– **Aggregate usage** \u2014 provider-reported token counts and cost (USD) per workflow run and chat turn, plus total loop iterations per run. Numeric totals only \u2014 never the content the tokens represent.
\n– **Machine context** \u2014 OS, architecture, Archon version, runtime, whether it’s a binary build, and a CI flag.
\n– **Deployment shape** (server only) \u2014 which adapters are enabled (booleans), database kind (`sqlite`\/`postgresql`), whether web auth and multi-user mode are on, and the GitHub auth mode. Configuration *values* (tokens, URLs, hosts) are never sent.
\n– A random install UUID stored at `~\/.archon\/telemetry-id`. Nothing else.<\/p>\n

**What’s *not* collected:** your code, prompts, messages, custom workflow names, workflow descriptions, git remotes, file paths, usernames, tokens, AI output, error message text, your IP address, your geographic location \u2014 none of it.<\/p>\n

**Opt out:** set any of these in your environment:<\/p>\n

“`bash
\nARCHON_TELEMETRY_DISABLED=1
\nDO_NOT_TRACK=1 # de facto standard honored by Astro, Bun, Prisma, Nuxt, etc.
\nPOSTHOG_API_KEY=off # off | 0 | false | disabled | “” all disable
\n“`<\/p>\n

CI environments (`CI=true`) are auto-disabled \u2014 forks running fixtures in GitHub Actions, CircleCI, etc. do not send events.<\/p>\n

**Check the current state:** run `archon telemetry status` to see whether telemetry is enabled, why (if not), the install UUID, and the active host. Run `archon telemetry reset` to rotate the install UUID. `archon doctor` also surfaces the current state in its check list.<\/p>\n

Self-host PostHog or use a different project by setting `POSTHOG_API_KEY` and `POSTHOG_HOST`.<\/p>\n

## Contributing<\/p>\n

Contributions welcome! See the open [issues](https:\/\/github.com\/coleam00\/Archon\/issues) for things to work on.<\/p>\n

Please read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting a pull request.<\/p>\n

## Star History<\/p>\n

[![Star History Chart](https:\/\/api.star-history.com\/chart?repos=coleam00\/Archon&type=date&legend=top-left)](https:\/\/www.star-history.com\/?repos=coleam00%2FArchon&type=date&legend=top-left)<\/p>\n

## License<\/p>\n

[MIT](LICENSE)<\/p>\n","protected":false},"excerpt":{"rendered":"

The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"ai_share_source_url":"https:\/\/github.com\/coleam00\/Archon","ai_share_source_title":"coleam00\/Archon","ai_share_status":"\u5df2\u6821\u9a8c","ai_share_official_url":"https:\/\/archon.diy","ai_share_original_content_language":"en","ai_share_i18n_original_source_language":"en","ai_share_tool_icon_attachment_id":89,"ai_share_author_label":"coleam00","ai_share_version_label":"v0.9.0","ai_share_primary_category":"\u7f16\u7a0b\u5f00\u53d1","ai_share_tool_type":"tool","ai_share_resource_type":"product","ai_share_platform_support":"Web,Docker,CLI","ai_share_collection":"Harness \/ Agent Engineering","ai_share_last_verified_at":"2026-05-08","ai_share_provider_observed_at":"2026-08-18T07:21:06.129Z","ai_share_last_commit_at":"2026-08-18T07:10:27Z","ai_share_license":"MIT","ai_share_language_support":"en","ai_share_target_user":"\u72ec\u7acb\u5f00\u53d1\u8005,\u5de5\u7a0b\u56e2\u961f,AI \u7f16\u7a0b\u6d41\u7a0b\u7ef4\u62a4\u8005","ai_share_github_topics":"ai, automation, bun, claude, cli, coding-assistant, developer-tools, typescript, workflow-engine, yaml","ai_share_repo_default_branch":"dev","ai_share_pricing_model":"open_source","ai_share_deployment_mode":"self_hosted","ai_share_delivery_mode":"","ai_share_region_availability":"global","ai_share_source_platform":"GitHub","ai_share_release_url":"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.9.0","ai_share_download_assets_json":"[{\"label\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-darwin-arm64\",\"size\":74939296,\"content_type\":\"application\/octet-stream\",\"download_count\":44,\"source\":\"github-release\",\"download\":true},{\"label\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-darwin-x64\",\"size\":79874624,\"content_type\":\"application\/octet-stream\",\"download_count\":3,\"source\":\"github-release\",\"download\":true},{\"label\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-linux-arm64\",\"size\":112500938,\"content_type\":\"application\/octet-stream\",\"download_count\":1,\"source\":\"github-release\",\"download\":true},{\"label\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-linux-x64\",\"size\":113059876,\"content_type\":\"application\/octet-stream\",\"download_count\":17,\"source\":\"github-release\",\"download\":true},{\"label\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-web.tar.gz\",\"size\":2170156,\"content_type\":\"application\/gzip\",\"download_count\":12,\"source\":\"github-release\",\"download\":true},{\"label\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-windows-x64.exe\",\"size\":129181696,\"content_type\":\"application\/x-msdos-program\",\"download_count\":22,\"source\":\"github-release\",\"download\":true},{\"label\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/checksums.txt\",\"size\":595,\"content_type\":\"text\/plain\",\"download_count\":42,\"source\":\"github-release\",\"download\":true}]","ai_share_github_releases_json":"[{\"tagName\":\"v0.9.0\",\"name\":\"Archon CLI v0.9.0\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.9.0\",\"body\":\"Workflows become properly composable: a workflow can now declare the arguments it takes and the result it returns, ship as one self-contained folder, and be simulated end to end without contacting a provider. Alongside that, a workflow node's capabilities become what its YAML declares rather than whatever happens to be configured on the operator's machine \u2014 see Breaking before upgrading.\\n\\n### Breaking\\n\\n- **Claude workflow nodes no longer inherit ambient skills and MCP servers.** A Claude node now sees exactly the skills and MCP servers its YAML declares, plus the native tools Archon injects for the run. User, project, and plugin MCP configuration on the operator's machine no longer reaches workflow nodes: a node that relied on an ambiently configured server must declare it with `mcp:`, and one that relied on an ambient skill must list it under `skills:`. Declared skills are now also checked before spend \u2014 a skill that is installed but unreachable from the node's enabled `settingSources` fails up front instead of silently going missing, while built-in and plugin-qualified (`plugin:skill`) names warn and are left for the SDK to resolve. Direct Claude chat, `CLAUDE.md`, and built-in, filesystem, and inline agents are unchanged. (#2535)\\n- **An included command body must resolve, and may only reference its own workflow.** `command:` and `loop.command` files inside an `include:` block are now resolved, validated, namespaced, and input-bound during load-time composition, recursing through nested `loop_group` bodies. Two previously tolerated shapes now fail: a body that references a node id outside the included workflow (it could bind whatever the caller happened to have) is rejected, and a body that cannot be resolved or read fails a fresh execution instead of warning and being skipped. Declare an input and pass it with `with:` instead of reaching outward. A paused loop still resumes from its persisted prompt snapshot even if its command file is later deleted. Included command bodies gained the other half of this trade: they can now use `$INPUTS.`, which Phase 1 rejected outright. (#2534, #2532)\\n\\n### Added\\n\\n- **Workflow signatures \u2014 `inputs:`, `returns:`, and `with:` on sub-runs.** A workflow can declare the named arguments it accepts and which node's output is its result, and a `workflow:` sub-run node can bind those arguments by name with `with:` instead of passing a single opaque `input:` string. Values arrive as `$INPUTS.` in prompts and command bodies, and as `INPUTS_` in `bash:`\/`script:` node environments. Missing required inputs and undeclared arguments are rejected before any worktree, clone, or provider cost, and `returns:` gives a stable author-chosen result channel in place of guessing the terminal sink. Workflows without `inputs:` keep their existing passthrough behavior byte for byte. (#2523)\\n- **`archon workflow run --dry-run` simulates a workflow without spending anything.** An in-memory simulator walks the DAG \u2014 routing, `when:` conditions, strict `$node.output` references, gates, and loops \u2014 and prints a deterministic human or `--json` trace. No provider is contacted and nothing is persisted: no run row, events, sessions, or worktrees. Node outputs can be stubbed, approval behavior chosen, and code nodes actually executed with `--exec-code` (they are stubbed by default). (#2530)\\n- **Packaged workflows \u2014 one folder holds a workflow and everything it uses.** `.archon\/workflows\/\/\/` is discovered as a package in both repo and home scope, and bare `command:` \/ `script:` references in that workflow's YAML bind to its own `commands\/` and `scripts\/` directories instead of the shared trees. Copying a workflow to another repo is now copying one folder rather than a scavenger hunt across three. Packaged resources are embedded in binary builds, and the Web API's workflow GET\/PUT\/DELETE lifecycle preserves the layout. Flat and one-level grouped YAML layouts are unaffected. (#2528)\\n\\n### Changed\\n\\n- **Codex workflow nodes no longer advertise ambient skills automatically.** Workflow commands and prompts now invoke installed Codex skills explicitly with `$skill-name`, an empty `skills: []` declaration is valid, and unsupported YAML fields warn honestly instead of implying support. Direct Codex chat is unchanged. This is a behavioral guard rather than filesystem isolation, and Codex MCP configuration remains additive to ambient servers. (#2498, #2533)\\n- **A malformed `settingSources` entry can only narrow Claude's scope, never widen it.** An unrecognized entry previously left the key unset, falling through to the permissive `['project', 'user']` default \u2014 so `settingSources: [projct]`, written to lock a node to project scope, silently granted full user-scope ambient access. Unrecognized entries are now dropped and logged, and workflow validation shares one parser with execution so the two can no longer disagree about a node's effective sources. (#2535)\\n- **Agent instructions live in one file.** `AGENTS.md` \u2014 which Codex, Pi, and OpenCode read natively \u2014 had drifted about six months behind `CLAUDE.md`. It is now the canonical instruction file, with `CLAUDE.md` reduced to a one-line pointer that Claude Code resolves as an import. No rule changed in the move. (#2497)\\n\\n### Fixed\\n\\n- **A schema upgrade can no longer crash-loop on an index that predates its column.** An index or `COMMENT ON COLUMN` placed beside its table body names a column that does not exist yet on an upgrade, because `CREATE TABLE IF NOT EXISTS` is a no-op there and the column only arrives in the later additive `ALTER TABLE` block. Since the schema applies in one transaction and re-throws, a single such statement aborted the whole apply and crash-looped every boot \u2014 on Postgres this broke startup and every CLI invocation for installs upgrading past #2414, and on SQLite it meant `new SqliteAdapter(...)` simply could not open a database created before `parent_conversation_id` existed. Every index and column comment now sits below the additive block. A new `check:schema-upgrades` CI job proves the current schema applies cleanly on top of every schema vintage ever released, re-applies idempotently, and lands on exactly the fresh-install shape. (#2513, #2552)\\n- **Workflow-level `modelReasoningEffort:` and `webSearchMode:` reach Codex.** Both had been schema-declared, loader-validated, and documented as working workflow-level options since March, but the executor never read them off the workflow definition \u2014 a workflow declaring either parsed cleanly, warned about nothing, and ran at the `config.yaml` or SDK default. Declaring either on a non-Codex node now produces the same loud capability-mismatch warning every other unsupported field produces. (#2559)\\n- **The container write-back no longer mis-decodes hostile or merely unusual filenames.** The two overlay walk scripts \u2014 the one place a container run writes the live root \u2014 decoded each entry by forking `basename`, `dirname`, and `sed`, which produced three reachable defects: a whiteout marker under a `-`-prefixed directory was planted as a literal `.wh.*` file instead of deleting its target (no adversary required, just a leading dash); a whiteout whose name ended in a newline deleted a different, innocent file and could write outside the live root while reporting success; and a TAB inside a filename or symlink target forged the positionally-decoded fields after it, presenting an escaping symlink to the approval gate as safe. Shell parameter expansion replaces the forks, closing all three and cutting forks per entry from 8 to 4 for a regular file and 6 to 1 for a whiteout. (#2561)\\n- **Archon no longer guesses the default branch.** `getDefaultBranch` ended its fallback chain by checking whether `\/main` merely existed and returning it if so. On a repository shaped like this one \u2014 `dev` is the default and `main` is the release branch \u2014 a run silently cut its worktree from `main` and targeted its pull request at `main`, with nothing erroring at the moment it happened. When `\/HEAD` is not a symbolic ref it now throws, naming `--base`, `worktree.baseBranch`, and the codebase `default_branch` field. (#2503)\\n- **`WORKFLOW_ID` is delivered to `bash:` and `script:` node subprocesses.** It substituted into the node body but was missing from the environment bag, unlike `ARTIFACTS_DIR`, `STATE_DIR`, and `LOG_DIR` sitting beside it \u2014 so a heredoc'd `python3` or `node` block reading `os.environ` failed inside the nested interpreter with a bare `KeyError` and no hint that its siblings worked fine. The `e2e-deterministic` fixture that demonstrated the wrong way to consume an output reference was corrected too. (#2511)\\n- **A dry run of the state migration no longer creates a database.** `scripts\/migrate-state-dir.ts` consulted the codebase registry unconditionally, and the SQLite adapter connects lazily and applies the full schema on first use \u2014 so a read-only run wrote a 704 KB database while printing `Dry run \u2014 nothing was moved`. (#2557)\\n\\n\\n---\\n\\nDiscussion thread \u2014 questions, or paste YAML that broke: https:\/\/github.com\/coleam00\/Archon\/discussions\/2574\",\"bodyExcerpt\":\"\",\"bodyTruncated\":false,\"publishedAt\":\"2026-08-17T12:48:02Z\",\"prerelease\":false,\"draft\":false,\"assetCount\":7,\"assets\":[{\"label\":\"archon-darwin-arm64\",\"name\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-darwin-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":74939296,\"download_count\":44},{\"label\":\"archon-darwin-x64\",\"name\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-darwin-x64\",\"content_type\":\"application\/octet-stream\",\"size\":79874624,\"download_count\":3},{\"label\":\"archon-linux-arm64\",\"name\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-linux-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":112500938,\"download_count\":1},{\"label\":\"archon-linux-x64\",\"name\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-linux-x64\",\"content_type\":\"application\/octet-stream\",\"size\":113059876,\"download_count\":17},{\"label\":\"archon-web.tar.gz\",\"name\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-web.tar.gz\",\"content_type\":\"application\/gzip\",\"size\":2170156,\"download_count\":12},{\"label\":\"archon-windows-x64.exe\",\"name\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/archon-windows-x64.exe\",\"content_type\":\"application\/x-msdos-program\",\"size\":129181696,\"download_count\":22},{\"label\":\"checksums.txt\",\"name\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.9.0\/checksums.txt\",\"content_type\":\"text\/plain\",\"size\":595,\"download_count\":42}]},{\"tagName\":\"v0.8.0\",\"name\":\"Archon CLI v0.8.0\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.8.0\",\"body\":\"## Installation\\n\\n### Quick Install (Recommended)\\n\\n**macOS \/ Linux**\\n```bash\\ncurl -fsSL https:\/\/archon.diy\/install | bash\\n```\\n\\n**Windows (PowerShell)**\\n```powershell\\nirm https:\/\/archon.diy\/install.ps1 | iex\\n```\\n\\n**Homebrew (macOS \/ Linux)**\\n```bash\\nbrew install coleam00\/archon\/archon\\n```\\n\\n**Docker**\\n```bash\\ndocker run --rm -v \\\"$PWD:\/workspace\\\" ghcr.io\/coleam00\/archon:latest workflow list\\n```\\n\\n### Manual Installation\\n\\n**macOS (Apple Silicon)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**macOS (Intel)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (x64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (ARM64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Windows (Manual)**\\nDownload `archon-windows-x64.exe` from the assets below, rename to `archon.exe`, and add to your PATH.\\n\\n### Verify installation\\n```bash\\narchon version\\n```\\n\\n\\n## What's Changed\\n* Release 0.8.0 by @Wirasm in https:\/\/github.com\/coleam00\/Archon\/pull\/2502\\n\\n\\n**Full Changelog**: https:\/\/github.com\/coleam00\/Archon\/compare\/v0.7.1...v0.8.0\",\"bodyExcerpt\":\"\",\"bodyTruncated\":false,\"publishedAt\":\"2026-08-06T12:29:49Z\",\"prerelease\":false,\"draft\":false,\"assetCount\":7,\"assets\":[{\"label\":\"archon-darwin-arm64\",\"name\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.8.0\/archon-darwin-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":74889760,\"download_count\":277},{\"label\":\"archon-darwin-x64\",\"name\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.8.0\/archon-darwin-x64\",\"content_type\":\"application\/octet-stream\",\"size\":79841856,\"download_count\":16},{\"label\":\"archon-linux-arm64\",\"name\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.8.0\/archon-linux-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":112460409,\"download_count\":37},{\"label\":\"archon-linux-x64\",\"name\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.8.0\/archon-linux-x64\",\"content_type\":\"application\/octet-stream\",\"size\":113019347,\"download_count\":118},{\"label\":\"archon-web.tar.gz\",\"name\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.8.0\/archon-web.tar.gz\",\"content_type\":\"application\/gzip\",\"size\":2170653,\"download_count\":95},{\"label\":\"archon-windows-x64.exe\",\"name\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.8.0\/archon-windows-x64.exe\",\"content_type\":\"application\/x-msdos-program\",\"size\":129141248,\"download_count\":92},{\"label\":\"checksums.txt\",\"name\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.8.0\/checksums.txt\",\"content_type\":\"text\/plain\",\"size\":595,\"download_count\":213}]},{\"tagName\":\"v0.7.1\",\"name\":\"Archon CLI v0.7.1\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.7.1\",\"body\":\"## Installation\\n\\n### Quick Install (Recommended)\\n\\n**macOS \/ Linux**\\n```bash\\ncurl -fsSL https:\/\/archon.diy\/install | bash\\n```\\n\\n**Windows (PowerShell)**\\n```powershell\\nirm https:\/\/archon.diy\/install.ps1 | iex\\n```\\n\\n**Homebrew (macOS \/ Linux)**\\n```bash\\nbrew install coleam00\/archon\/archon\\n```\\n\\n**Docker**\\n```bash\\ndocker run --rm -v \\\"$PWD:\/workspace\\\" ghcr.io\/coleam00\/archon:latest workflow list\\n```\\n\\n### Manual Installation\\n\\n**macOS (Apple Silicon)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**macOS (Intel)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (x64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (ARM64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Windows (Manual)**\\nDownload `archon-windows-x64.exe` from the assets below, rename to `archon.exe`, and add to your PATH.\\n\\n### Verify installation\\n```bash\\narchon version\\n```\\n\\n\\n## What's Changed\\n* Update docs.mdx by @matt2000 in https:\/\/github.com\/coleam00\/Archon\/pull\/2155\\n* Release 0.7.1 by @Wirasm in https:\/\/github.com\/coleam00\/Archon\/pull\/2435\\n\\n\\n**Full Changelog**: https:\/\/github.com\/coleam00\/Archon\/compare\/v0.7.0...v0.7.1\",\"bodyExcerpt\":\"\",\"bodyTruncated\":false,\"publishedAt\":\"2026-08-04T11:20:53Z\",\"prerelease\":false,\"draft\":false,\"assetCount\":7,\"assets\":[{\"label\":\"archon-darwin-arm64\",\"name\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.1\/archon-darwin-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":74856736,\"download_count\":89},{\"label\":\"archon-darwin-x64\",\"name\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.1\/archon-darwin-x64\",\"content_type\":\"application\/octet-stream\",\"size\":79809088,\"download_count\":12},{\"label\":\"archon-linux-arm64\",\"name\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.1\/archon-linux-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":112425092,\"download_count\":10},{\"label\":\"archon-linux-x64\",\"name\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.1\/archon-linux-x64\",\"content_type\":\"application\/octet-stream\",\"size\":112984030,\"download_count\":56},{\"label\":\"archon-web.tar.gz\",\"name\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.1\/archon-web.tar.gz\",\"content_type\":\"application\/gzip\",\"size\":2169473,\"download_count\":47},{\"label\":\"archon-windows-x64.exe\",\"name\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.1\/archon-windows-x64.exe\",\"content_type\":\"application\/x-msdos-program\",\"size\":129105920,\"download_count\":35},{\"label\":\"checksums.txt\",\"name\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.1\/checksums.txt\",\"content_type\":\"text\/plain\",\"size\":595,\"download_count\":66}]},{\"tagName\":\"v0.7.0\",\"name\":\"Archon CLI v0.7.0\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.7.0\",\"body\":\"## Installation\\n\\n### Quick Install (Recommended)\\n\\n**macOS \/ Linux**\\n```bash\\ncurl -fsSL https:\/\/archon.diy\/install | bash\\n```\\n\\n**Windows (PowerShell)**\\n```powershell\\nirm https:\/\/archon.diy\/install.ps1 | iex\\n```\\n\\n**Homebrew (macOS \/ Linux)**\\n```bash\\nbrew install coleam00\/archon\/archon\\n```\\n\\n**Docker**\\n```bash\\ndocker run --rm -v \\\"$PWD:\/workspace\\\" ghcr.io\/coleam00\/archon:latest workflow list\\n```\\n\\n### Manual Installation\\n\\n**macOS (Apple Silicon)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**macOS (Intel)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (x64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (ARM64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Windows (Manual)**\\nDownload `archon-windows-x64.exe` from the assets below, rename to `archon.exe`, and add to your PATH.\\n\\n### Verify installation\\n```bash\\narchon version\\n```\\n\\n\\n## What's Changed\\n* Release 0.7.0 by @Wirasm in https:\/\/github.com\/coleam00\/Archon\/pull\/2361\\n\\n\\n**Full Changelog**: https:\/\/github.com\/coleam00\/Archon\/compare\/v0.6.0...v0.7.0\",\"bodyExcerpt\":\"\",\"bodyTruncated\":false,\"publishedAt\":\"2026-08-02T07:34:34Z\",\"prerelease\":false,\"draft\":false,\"assetCount\":7,\"assets\":[{\"label\":\"archon-darwin-arm64\",\"name\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.0\/archon-darwin-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":74823712,\"download_count\":86},{\"label\":\"archon-darwin-x64\",\"name\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.0\/archon-darwin-x64\",\"content_type\":\"application\/octet-stream\",\"size\":79776320,\"download_count\":8},{\"label\":\"archon-linux-arm64\",\"name\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.0\/archon-linux-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":112400941,\"download_count\":15},{\"label\":\"archon-linux-x64\",\"name\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.0\/archon-linux-x64\",\"content_type\":\"application\/octet-stream\",\"size\":112959879,\"download_count\":41},{\"label\":\"archon-web.tar.gz\",\"name\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.0\/archon-web.tar.gz\",\"content_type\":\"application\/gzip\",\"size\":2169475,\"download_count\":35},{\"label\":\"archon-windows-x64.exe\",\"name\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.0\/archon-windows-x64.exe\",\"content_type\":\"application\/x-msdos-program\",\"size\":129081856,\"download_count\":30},{\"label\":\"checksums.txt\",\"name\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.7.0\/checksums.txt\",\"content_type\":\"text\/plain\",\"size\":595,\"download_count\":56}]},{\"tagName\":\"v0.6.0\",\"name\":\"Archon CLI v0.6.0\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.6.0\",\"body\":\"## Installation\\n\\n### Quick Install (Recommended)\\n\\n**macOS \/ Linux**\\n```bash\\ncurl -fsSL https:\/\/archon.diy\/install | bash\\n```\\n\\n**Windows (PowerShell)**\\n```powershell\\nirm https:\/\/archon.diy\/install.ps1 | iex\\n```\\n\\n**Homebrew (macOS \/ Linux)**\\n```bash\\nbrew install coleam00\/archon\/archon\\n```\\n\\n**Docker**\\n```bash\\ndocker run --rm -v \\\"$PWD:\/workspace\\\" ghcr.io\/coleam00\/archon:latest workflow list\\n```\\n\\n### Manual Installation\\n\\n**macOS (Apple Silicon)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**macOS (Intel)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (x64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (ARM64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Windows (Manual)**\\nDownload `archon-windows-x64.exe` from the assets below, rename to `archon.exe`, and add to your PATH.\\n\\n### Verify installation\\n```bash\\narchon version\\n```\\n\\n\\n## What's Changed\\n* marketplace: add token-max-site-factory (programmatic SEO\/GEO page factory) by @TheSmokeDev in https:\/\/github.com\/coleam00\/Archon\/pull\/2057\\n* marketplace: add image-node-factory (grounded image prompt-pack workflow) by @TheSmokeDev in https:\/\/github.com\/coleam00\/Archon\/pull\/2077\\n* Release 0.6.0 by @Wirasm in https:\/\/github.com\/coleam00\/Archon\/pull\/2202\\n\\n## New Contributors\\n* @TheSmokeDev made their first contribution in https:\/\/github.com\/coleam00\/Archon\/pull\/2057\\n\\n**Full Changelog**: https:\/\/github.com\/coleam00\/Archon\/compare\/v0.5.0...v0.6.0\",\"bodyExcerpt\":\"\",\"bodyTruncated\":false,\"publishedAt\":\"2026-07-20T19:33:16Z\",\"prerelease\":false,\"draft\":false,\"assetCount\":7,\"assets\":[{\"label\":\"archon-darwin-arm64\",\"name\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.6.0\/archon-darwin-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":74790688,\"download_count\":281},{\"label\":\"archon-darwin-x64\",\"name\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.6.0\/archon-darwin-x64\",\"content_type\":\"application\/octet-stream\",\"size\":79743552,\"download_count\":29},{\"label\":\"archon-linux-arm64\",\"name\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.6.0\/archon-linux-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":112361567,\"download_count\":16},{\"label\":\"archon-linux-x64\",\"name\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.6.0\/archon-linux-x64\",\"content_type\":\"application\/octet-stream\",\"size\":112920505,\"download_count\":606},{\"label\":\"archon-web.tar.gz\",\"name\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.6.0\/archon-web.tar.gz\",\"content_type\":\"application\/gzip\",\"size\":2148240,\"download_count\":135},{\"label\":\"archon-windows-x64.exe\",\"name\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.6.0\/archon-windows-x64.exe\",\"content_type\":\"application\/x-msdos-program\",\"size\":129042432,\"download_count\":138},{\"label\":\"checksums.txt\",\"name\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.6.0\/checksums.txt\",\"content_type\":\"text\/plain\",\"size\":595,\"download_count\":652}]},{\"tagName\":\"v0.5.0\",\"name\":\"Archon CLI v0.5.0\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.5.0\",\"body\":\"## Installation\\n\\n### Quick Install (Recommended)\\n\\n**macOS \/ Linux**\\n```bash\\ncurl -fsSL https:\/\/archon.diy\/install | bash\\n```\\n\\n**Windows (PowerShell)**\\n```powershell\\nirm https:\/\/archon.diy\/install.ps1 | iex\\n```\\n\\n**Homebrew (macOS \/ Linux)**\\n```bash\\nbrew install coleam00\/archon\/archon\\n```\\n\\n**Docker**\\n```bash\\ndocker run --rm -v \\\"$PWD:\/workspace\\\" ghcr.io\/coleam00\/archon:latest workflow list\\n```\\n\\n### Manual Installation\\n\\n**macOS (Apple Silicon)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**macOS (Intel)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (x64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (ARM64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Windows (Manual)**\\nDownload `archon-windows-x64.exe` from the assets below, rename to `archon.exe`, and add to your PATH.\\n\\n### Verify installation\\n```bash\\narchon version\\n```\\n\\n\\n## What's Changed\\n* Release 0.5.0 by @Wirasm in https:\/\/github.com\/coleam00\/Archon\/pull\/2042\\n\\n\\n**Full Changelog**: https:\/\/github.com\/coleam00\/Archon\/compare\/v0.4.1...v0.5.0\",\"bodyExcerpt\":\"\",\"bodyTruncated\":false,\"publishedAt\":\"2026-06-26T16:45:16Z\",\"prerelease\":false,\"draft\":false,\"assetCount\":7,\"assets\":[{\"label\":\"archon-darwin-arm64\",\"name\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.5.0\/archon-darwin-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":73882528,\"download_count\":501},{\"label\":\"archon-darwin-x64\",\"name\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.5.0\/archon-darwin-x64\",\"content_type\":\"application\/octet-stream\",\"size\":78826048,\"download_count\":43},{\"label\":\"archon-linux-arm64\",\"name\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.5.0\/archon-linux-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":111452646,\"download_count\":40},{\"label\":\"archon-linux-x64\",\"name\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.5.0\/archon-linux-x64\",\"content_type\":\"application\/octet-stream\",\"size\":112011584,\"download_count\":598},{\"label\":\"archon-web.tar.gz\",\"name\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.5.0\/archon-web.tar.gz\",\"content_type\":\"application\/gzip\",\"size\":2038210,\"download_count\":294},{\"label\":\"archon-windows-x64.exe\",\"name\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.5.0\/archon-windows-x64.exe\",\"content_type\":\"application\/x-msdos-program\",\"size\":128132608,\"download_count\":303},{\"label\":\"checksums.txt\",\"name\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.5.0\/checksums.txt\",\"content_type\":\"text\/plain\",\"size\":595,\"download_count\":1127}]},{\"tagName\":\"v0.4.1\",\"name\":\"Archon CLI v0.4.1\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.4.1\",\"body\":\"## Installation\\n\\n### Quick Install (Recommended)\\n\\n**macOS \/ Linux**\\n```bash\\ncurl -fsSL https:\/\/archon.diy\/install | bash\\n```\\n\\n**Windows (PowerShell)**\\n```powershell\\nirm https:\/\/archon.diy\/install.ps1 | iex\\n```\\n\\n**Homebrew (macOS \/ Linux)**\\n```bash\\nbrew install coleam00\/archon\/archon\\n```\\n\\n**Docker**\\n```bash\\ndocker run --rm -v \\\"$PWD:\/workspace\\\" ghcr.io\/coleam00\/archon:latest workflow list\\n```\\n\\n### Manual Installation\\n\\n**macOS (Apple Silicon)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**macOS (Intel)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-darwin-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (x64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-x64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Linux (ARM64)**\\n```bash\\ncurl -fsSL https:\/\/github.com\/coleam00\/Archon\/releases\/latest\/download\/archon-linux-arm64 -o \/usr\/local\/bin\/archon\\nchmod +x \/usr\/local\/bin\/archon\\n```\\n\\n**Windows (Manual)**\\nDownload `archon-windows-x64.exe` from the assets below, rename to `archon.exe`, and add to your PATH.\\n\\n### Verify installation\\n```bash\\narchon version\\n```\\n\\n\\n## What's Changed\\n* Release 0.4.1 by @Wirasm in https:\/\/github.com\/coleam00\/Archon\/pull\/1793\\n\\n\\n**Full Changelog**: https:\/\/github.com\/coleam00\/Archon\/compare\/v0.4.0...v0.4.1\",\"bodyExcerpt\":\"\",\"bodyTruncated\":false,\"publishedAt\":\"2026-05-28T13:53:24Z\",\"prerelease\":false,\"draft\":false,\"assetCount\":7,\"assets\":[{\"label\":\"archon-darwin-arm64\",\"name\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.1\/archon-darwin-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":72445984,\"download_count\":890},{\"label\":\"archon-darwin-x64\",\"name\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.1\/archon-darwin-x64\",\"content_type\":\"application\/octet-stream\",\"size\":77417024,\"download_count\":108},{\"label\":\"archon-linux-arm64\",\"name\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.1\/archon-linux-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":110035629,\"download_count\":57},{\"label\":\"archon-linux-x64\",\"name\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.1\/archon-linux-x64\",\"content_type\":\"application\/octet-stream\",\"size\":110594571,\"download_count\":1464},{\"label\":\"archon-web.tar.gz\",\"name\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.1\/archon-web.tar.gz\",\"content_type\":\"application\/gzip\",\"size\":1864831,\"download_count\":485},{\"label\":\"archon-windows-x64.exe\",\"name\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.1\/archon-windows-x64.exe\",\"content_type\":\"application\/x-msdos-program\",\"size\":126715392,\"download_count\":598},{\"label\":\"checksums.txt\",\"name\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.1\/checksums.txt\",\"content_type\":\"text\/plain\",\"size\":595,\"download_count\":2559}]},{\"tagName\":\"v0.4.0\",\"name\":\"v0.4.0\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/tag\/v0.4.0\",\"body\":\"GitHub App auth for the bot, multi-user attribution, Slack UX overhaul, experimental `\/console`, two new community providers (OpenCode and GitHub Copilot), Codex MCP support, and broad workflow\/provider hardening.\\n\\n### Added\\n\\n- **GitHub App authentication for the bot**: replaces the shared `GITHUB_TOKEN` PAT with a GitHub App + multi-installation routing. Each repo resolves to the installation that owns it; tokens are minted on demand, cached per installation, refreshed before expiry, and never persisted. Includes a loopback-only `\/internal\/git-credential` endpoint (with a hard `127.0.0.1` bind check, opt-out via `ARCHON_ALLOW_INTERNAL_ON_PUBLIC_BIND=1`) so long-running workflow `git` operations can transparently refresh installation tokens via a `git-credential-archon` helper installed into the worktree's `.git\/config` (#1788).\\n- **Per-user attribution**: `user_id` is now plumbed from chat and forge adapters through the orchestrator into `conversations`, `messages`, `workflow_runs`, and `isolation_environments`. New `users` and `user_identities` tables map platform identities (Slack U-id, Telegram chat id, Discord snowflake, GitHub login) to an Archon-internal user, created lazily on first sight (#1783).\\n- **Slack UX upgrade**: interactive buttons, status reactions, and native slash commands replace the previous text-only flow. Approval gates, run status, and errors are now surfaced through Slack's UI primitives (#1757).\\n- **Experimental run-centric console UI** at `\/console`, mounted as an isolated in-repo spike under `packages\/web\/src\/experiments\/console\/`. Lint-guarded against importing production web modules so it can be dropped in or deleted cleanly (#1747).\\n- **`assistants.opencode` provider**: community provider that runs OpenCode as an embedded runtime, with per-node agent materialization, multi-agent sessions, structured output, token usage, and multi-agent MCP tool execution (#1384).\\n- **GitHub Copilot community provider**: registered as a `builtIn: false` provider in the registry (#1505).\\n- **Codex MCP nodes**: MCP server support for Codex workflow nodes via the shared `loadMcpConfig` module \u2014 pass `mcp: ` on a Codex node and the config is translated to Codex's `mcp_servers` overrides at runtime. MCP client errors are surfaced to the workflow author as `system` chunks when MCP is explicitly configured for the node (#1459).\\n- **`always_run` node opt-out for resume caching**: opt-out for nodes that must re-execute on every resume rather than being skipped as \\\"already completed\\\" (closes #1391, #1730).\\n- **Pi deferred extension model resolution** so Pi workflows can reference models that are only available after extension loading (#1509).\\n- **Brand foundation page** at https:\/\/archon.diy\/brand\/, sourced from `packages\/docs-web\/src\/content\/docs\/brand\/` (#1745).\\n- **New marketplace workflows**: `piv-system-evolution` and `archon-comprehensive-mr-review`.\\n\\n### Changed\\n\\n- **Streaming chat continuity**: typing indicators and message boundaries are more readable; rapid successive chunks no longer fragment visually (#1617).\\n- **Web chat bubbles** wrap long unbreakable strings instead of overflowing (fixes #1738, #1742).\\n- **Web DAG builder** recognizes `loop` and `approval` node types and renders them correctly (#1744).\\n- **Web execution graph** surfaces workflow-definition fetch errors instead of silently rendering an empty graph (#1683, #1698).\\n- **Web copy-message button** handles clipboard failures gracefully (#1564).\\n- **Telegramify-markdown** bumped to 1.3.3 for correct blockquote escaping (#1340).\\n- **Webhook clones** are placed in the workspace `source\/` subdirectory to match the standard workspace layout (#1554).\\n- **Global workflows** are now editable through the Web UI builder (#1557).\\n- **`safeSendMessage`** consolidated into `executor-shared` to remove duplication across executor variants (#1496).\\n- **Direction docs**: community-providers policy section added (#1736).\\n\\n### Fixed\\n\\n- **`workflow approve\/resume\/reject` no longer fail with \\\"Workflow not found\\\" when the run's working path is a worktree or workspace clone.** Resume, approve, and reject now use `codebase.default_cwd` for workflow YAML discovery, falling back to `working_path` when no codebase record is found. Fixes #1663 (#1743).\\n- **Resume interactive workflows on chat platforms**: previously failed because the resume code path assumed web; now works for Slack and Telegram (#1756).\\n- **Web approve\/reject responses** surface the CLI resume command so users can copy it directly instead of having to look it up (#1523).\\n- **`DEFAULT_AI_ASSISTANT`** is now read in `createCodebase` so the env var actually controls the default assistant for newly registered codebases (fixes #1703, #1746).\\n- **Marketplace `decide` node** hardened against non-JSON ai-review output so a prose-prefixed verdict doesn't crash the workflow.\\n- **MCP config env vars** now expand `${VAR_NAME}` brace syntax in addition to `$VAR_NAME` (#1728).\\n- **`archon-refactor-safely`** persists read-only node outputs via bash bridges so downstream nodes can reference them (#1734).\\n- **Workflow builder** injects `$ARGUMENTS` into generated YAMLs so user arguments reach the first node (#1733).\\n- **Codex provider**: removed stale `attemptController.abort()` that crashed after SDK cleanup (#1735, #1739); fresh `AbortController` per retry attempt so a previously-aborted controller can't kill the new attempt (#1266, #1371).\\n- **Claude provider** rejects directory paths in `claudeBinaryPath` and expands npm platform-package directories (e.g. `@anthropic-ai\/claude-code-darwin-arm64`) to the bundled binary (#1723, #1737).\\n- **Default assistant resolution**: now consults config + per-folder detection on every codebase registration, not just the first (#1729).\\n- **Large node outputs** are written to a temp file and referenced rather than inlined into bash substitution, preventing argument-list corruption on big payloads (fixes #1717, #1718).\\n- **Forge clone auth** resolves credentials via configured `*_URL` env vars rather than assuming `github.com` (fixes #1704, #1706); non-GitHub forge URLs authenticate via `GITLAB_TOKEN` \/ `GITEA_TOKEN` (fixes #1655, #1658).\\n- **DAG multi-resume**: completed node state is now preserved across multiple resume cycles instead of being recomputed (#1530).\\n- **Bash node variables**: user-controlled variables are passed via env vars, not shell substitution, to avoid quoting bugs and injection edge cases (#1651).\\n- **Scripts**: `ARCHON_STATE_JSON` marker extraction uses line-anchored regex so embedded marker-like strings in script output don't confuse the parser (#1695).\\n- **Workflows**: `condition_json_parse_failed` is now surfaced as a workflow error instead of silently skipping the conditional branch (#1673, #1694).\",\"bodyExcerpt\":\"\",\"bodyTruncated\":false,\"publishedAt\":\"2026-05-28T13:13:00Z\",\"prerelease\":false,\"draft\":false,\"assetCount\":7,\"assets\":[{\"label\":\"archon-darwin-arm64\",\"name\":\"archon-darwin-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.0\/archon-darwin-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":72445984,\"download_count\":12},{\"label\":\"archon-darwin-x64\",\"name\":\"archon-darwin-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.0\/archon-darwin-x64\",\"content_type\":\"application\/octet-stream\",\"size\":77417024,\"download_count\":7},{\"label\":\"archon-linux-arm64\",\"name\":\"archon-linux-arm64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.0\/archon-linux-arm64\",\"content_type\":\"application\/octet-stream\",\"size\":110035278,\"download_count\":8},{\"label\":\"archon-linux-x64\",\"name\":\"archon-linux-x64\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.0\/archon-linux-x64\",\"content_type\":\"application\/octet-stream\",\"size\":110594220,\"download_count\":12},{\"label\":\"archon-web.tar.gz\",\"name\":\"archon-web.tar.gz\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.0\/archon-web.tar.gz\",\"content_type\":\"application\/gzip\",\"size\":1864832,\"download_count\":13},{\"label\":\"archon-windows-x64.exe\",\"name\":\"archon-windows-x64.exe\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.0\/archon-windows-x64.exe\",\"content_type\":\"application\/x-msdos-program\",\"size\":126714880,\"download_count\":9},{\"label\":\"checksums.txt\",\"name\":\"checksums.txt\",\"url\":\"https:\/\/github.com\/coleam00\/Archon\/releases\/download\/v0.4.0\/checksums.txt\",\"content_type\":\"text\/plain\",\"size\":595,\"download_count\":18}]}]","ai_share_view_count":6105,"ai_share_bookmark_count":260,"ai_share_first_party_view_count":53,"ai_share_github_stars":23221,"ai_share_github_watchers":229,"ai_share_github_forks":3463,"ai_share_github_open_issues":271,"ai_share_api_available":true,"ai_share_open_source":true,"ai_share_repo_url":"https:\/\/github.com\/coleam00\/Archon","ai_share_documentation_url":"https:\/\/archon.diy\/reference\/api\/","creator_slug":"coleam00","creator_name":"coleam00","creator_status":"external","creator_intro":"Generative AI specialist with a wide range of experience developing AI Agents, RAG solutions, local AI deployments, generative AI libraries\/packages, and more.","creator_github_url":"https:\/\/github.com\/coleam00","creator_avatar_url":"https:\/\/avatars.githubusercontent.com\/u\/47287758?v=4","ai_share_github_readme_path":"README.md","ai_share_github_readme_sha":"8afe22f32c4a65bc0e35a7302b554fd5fa00838f","ai_share_github_readme_hash":"fe9acd516e573eee3027dd25ce8052b528063d3d48123316858c67149f6409a1","ai_share_github_readme_language":"en","ai_share_github_readme_format":"markdown","ai_share_github_description":"The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.","ai_share_one_sentence_definition":"The first open-source harness builder for AI coding.","ai_share_one_sentence_definition_en":"The first open-source harness builder for AI coding.","ai_share_github_readme_url":"https:\/\/github.com\/coleam00\/Archon\/blob\/dev\/README.md","ai_share_github_readme_raw_url":"https:\/\/raw.githubusercontent.com\/coleam00\/Archon\/dev\/README.md","ai_share_github_readme_markdown":"

\n \"Archon\"\n<\/p>\n\n

Archon<\/h1>\n\n

\n The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.\n<\/p>\n\n

\n \"coleam00%2FArchon<\/a>\n<\/p>\n\n

\n \"License:<\/a>\n \"CI\"<\/a>\n \"Docs\"<\/a>\n<\/p>\n\n---\n\nArchon is a workflow engine for AI coding agents. Define your development processes as YAML workflows - planning, implementation, validation, code review, PR creation - and run them reliably across all your projects.\n\nLike what Dockerfiles did for infrastructure and GitHub Actions did for CI\/CD - Archon does for AI coding workflows. Think n8n, but for software development.\n\n## Why Archon?\n\nWhen you ask an AI agent to \"fix this bug\", what happens depends on the model's mood. It might skip planning. It might forget to run tests. It might write a PR description that ignores your template. Every run is different.\n\nArchon fixes this. Encode your development process as a workflow. The workflow defines the phases, validation gates, and artifacts. The AI fills in the intelligence at each step, but the structure is deterministic and owned by you.\n\n- **Repeatable** - Same workflow, same sequence, every time. Plan, implement, validate, review, PR.\n- **Isolated** - Every workflow run gets its own git worktree. Run 5 fixes in parallel with no conflicts.\n- **Fire and forget** - Kick off a workflow, go do other work. Come back to a finished PR with review comments.\n- **Composable** - Mix deterministic nodes (bash scripts, tests, git ops) with AI nodes (planning, code generation, review). The AI only runs where it adds value.\n- **Portable** - Define workflows once in `.archon\/workflows\/`, commit them to your repo. They work the same from CLI, Web UI, Slack, Telegram, or GitHub.\n\n## What It Looks Like\n\nHere's an example of an Archon workflow that plans, implements in a loop until tests pass, gets your approval, then creates the PR:\n\n```yaml\n# .archon\/workflows\/build-feature.yaml\nnodes:\n - id: plan\n prompt: \"Explore the codebase and create an implementation plan\"\n\n - id: implement\n depends_on: [plan]\n loop: # AI loop - iterate until done\n prompt: \"Read the plan. Implement the next task. Run validation.\"\n until: ALL_TASKS_COMPLETE\n fresh_context: true # Fresh session each iteration\n\n - id: run-tests\n depends_on: [implement]\n bash: \"bun run validate\" # Deterministic - no AI\n\n - id: review\n depends_on: [run-tests]\n prompt: \"Review all changes against the plan. Fix any issues.\"\n\n - id: approve\n depends_on: [review]\n loop: # Human approval gate\n prompt: \"Present the changes for review. Address any feedback.\"\n until: APPROVED\n interactive: true # Pauses and waits for human input\n\n - id: create-pr\n depends_on: [approve]\n prompt: \"Push changes and create a pull request\"\n```\n\nTell your coding agent what you want, and Archon handles the rest:\n\n```\nYou: Use archon to add dark mode to the settings page\n\nAgent: I'll run the archon-idea-to-pr workflow for this.\n \u2192 Creating isolated worktree on branch archon\/task-dark-mode...\n \u2192 Planning...\n \u2192 Implementing (task 1\/4)...\n \u2192 Implementing (task 2\/4)...\n \u2192 Tests failing - iterating...\n \u2192 Tests passing after 2 iterations\n \u2192 Code review complete - 0 issues\n \u2192 PR ready: https:\/\/github.com\/you\/project\/pull\/47\n```\n\n## Previous Version\n\nLooking for the original Python-based Archon (task management + RAG)? It's fully preserved on the [`archive\/v1-task-management-rag`](https:\/\/github.com\/coleam00\/Archon\/tree\/archive\/v1-task-management-rag) branch.\n\n## Getting Started\n\n> **Most users should start with the [Full Setup](#full-setup-5-minutes)** - it walks you through credentials, installs the Archon skill into your projects, and gives you the web dashboard.\n>\n> **Already have Claude Code and just want the CLI?** Jump to the [Quick Install](#quick-install-30-seconds).\n\n### Full Setup (5 minutes)\n\nClone the repo and use the guided setup wizard. This configures credentials, platform integrations, and copies the Archon skill into your target projects.\n\n

\nPrerequisites<\/b> - Bun, Claude Code, and the GitHub CLI<\/summary>\n\n**Bun** - [bun.sh](https:\/\/bun.sh)\n\n```bash\n# macOS\/Linux\ncurl -fsSL https:\/\/bun.sh\/install | bash\n\n# Windows (PowerShell)\nirm bun.sh\/install.ps1 | iex\n```\n\n**GitHub CLI** - [cli.github.com](https:\/\/cli.github.com\/)\n\n```bash\n# macOS\nbrew install gh\n\n# Windows (via winget)\nwinget install GitHub.cli\n\n# Linux (Debian\/Ubuntu)\nsudo apt install gh\n```\n\n**Claude Code** - [claude.ai\/code](https:\/\/claude.ai\/code)\n\n```bash\n# macOS\/Linux\/WSL\ncurl -fsSL https:\/\/claude.ai\/install.sh | bash\n\n# Windows (PowerShell)\nirm https:\/\/claude.ai\/install.ps1 | iex\n```\n\n<\/details>\n\n```bash\ngit clone https:\/\/github.com\/coleam00\/Archon\ncd Archon\nbun install\nclaude\n```\n\nThen say: **\"Set up Archon\"**\n\nThe setup wizard walks you through everything: CLI installation, authentication, platform selection, and copies the Archon skill to your target repo.\n\n### Quick Install (30 seconds)\n\nAlready have Claude Code set up? Install the standalone CLI binary and skip the wizard.\n\n**macOS \/ Linux**\n```bash\ncurl -fsSL https:\/\/archon.diy\/install | bash\n```\n\n> **x64 compatibility:** The macOS\/Linux quick install requires AVX2 on x64\n> CPUs. Older Intel\/AMD hardware and virtual machines that mask AVX2 should use\n> the [source installation guide](https:\/\/archon.diy\/getting-started\/installation\/#from-source).\n> ARM64 quick installs are unaffected.\n\n**Windows (PowerShell)**\n```powershell\nirm https:\/\/archon.diy\/install.ps1 | iex\n```\n\n**Homebrew**\n```bash\nbrew install coleam00\/archon\/archon\n```\n\n> **Compiled binaries need a `CLAUDE_BIN_PATH`.** The quick-install binaries\n> don't bundle Claude Code. Install it separately, then point Archon at it:\n>\n> ```bash\n> # macOS \/ Linux \/ WSL\n> curl -fsSL https:\/\/claude.ai\/install.sh | bash\n> export CLAUDE_BIN_PATH=\"$HOME\/.local\/bin\/claude\"\n>\n> # Windows (PowerShell)\n> irm https:\/\/claude.ai\/install.ps1 | iex\n> $env:CLAUDE_BIN_PATH = \"$env:USERPROFILE\\.local\\bin\\claude.exe\"\n> ```\n>\n> Or set `assistants.claude.claudeBinaryPath` in `~\/.archon\/config.yaml`.\n> The Docker image ships Claude Code pre-installed. See [AI Assistants \u2192 Binary path configuration](https:\/\/archon.diy\/getting-started\/ai-assistants\/#binary-path-configuration-compiled-binaries-only) for details.\n\n### Start Using Archon\n\nOnce you've completed either setup path, go to your project and start working:\n\n```bash\ncd \/path\/to\/your\/project\nclaude\n```\n\n```\nUse archon to fix issue #42\n```\n\n```\nWhat archon workflows do I have? When would I use each one?\n```\n\nThe coding agent handles workflow selection, branch naming, and worktree isolation for you. Projects are registered automatically the first time they're used.\n\n> **Important:** Always run Claude Code from your target repo, not from the Archon repo. The setup wizard copies the Archon skill into your project so it works from there.\n\n## Web UI\n\nArchon includes a web dashboard for chatting with your coding agent, running workflows, and monitoring activity. Binary installs: run `archon serve` to download and start the web UI in one step. From source: ask your coding agent to run the frontend from the Archon repo, or run `bun run dev` from the repo root yourself.\n\nRegister a project by clicking **+** next to \"Project\" in the chat sidebar - enter a GitHub URL or local path. Then start a conversation, invoke workflows, and watch progress in real time.\n\n**Key pages:**\n- **Chat** - Conversation interface with real-time streaming and tool call visualization\n- **Dashboard** - Mission Control for monitoring running workflows, with filterable history by project, status, and date\n- **Workflow Builder** - Visual drag-and-drop editor for creating DAG workflows with loop nodes\n- **Workflow Execution** - Step-by-step progress view for any running or completed workflow\n\n**Monitoring hub:** The sidebar shows conversations from **all platforms** - not just the web. Workflows kicked off from the CLI, messages from Slack or Telegram, GitHub issue interactions - everything appears in one place.\n\nSee the [Web UI Guide](https:\/\/archon.diy\/adapters\/web\/) for full documentation.\n\n## What Can You Automate?\n\nArchon ships with workflows for common development tasks:\n\n| Workflow | What it does |\n|----------|-------------|\n| `archon-assist` | General Q&A, debugging, exploration - full Claude Code agent with all tools |\n| `archon-fix-github-issue` | Classify issue \u2192 investigate\/plan \u2192 implement \u2192 validate \u2192 PR \u2192 smart review \u2192 self-fix |\n| `archon-create-issue` | Classify problem \u2192 gather context \u2192 investigate \u2192 create GitHub issue |\n| `archon-issue-review-full` | Comprehensive fix + full multi-agent review pipeline for GitHub issues |\n| `archon-piv-loop` | Guided Plan-Implement-Validate loop with human review between iterations |\n| `archon-idea-to-pr` | Feature idea \u2192 plan \u2192 implement \u2192 validate \u2192 PR \u2192 5 parallel reviews \u2192 self-fix |\n| `archon-plan-to-pr` | Execute existing plan \u2192 implement \u2192 validate \u2192 PR \u2192 review \u2192 self-fix |\n| `archon-feature-development` | Implement feature from plan \u2192 validate \u2192 create PR |\n| `archon-adversarial-dev` | Build a complete application from scratch using adversarial development |\n| `archon-smart-pr-review` | Classify PR complexity \u2192 run targeted review agents \u2192 synthesize findings |\n| `archon-comprehensive-pr-review` | Multi-agent PR review (5 parallel reviewers) with automatic fixes |\n| `archon-validate-pr` | Thorough PR validation testing both main and feature branches |\n| `archon-architect` | Architectural sweep, complexity reduction, codebase health improvement |\n| `archon-refactor-safely` | Safe refactoring with type-check hooks and behavior verification |\n| `archon-interactive-prd` | Create a PRD through guided conversation |\n| `archon-ralph-dag` | PRD implementation loop - iterate through stories until done |\n| `archon-workflow-builder` | Generate a new Archon workflow YAML for your project |\n| `archon-remotion-generate` | Generate or modify Remotion video compositions with AI |\n| `archon-resolve-conflicts` | Detect merge conflicts \u2192 analyze both sides \u2192 resolve \u2192 validate \u2192 commit |\n\nArchon ships 19 default workflows - run `archon workflow list` or describe what you want and the router picks the right one.\n\n**Or define your own.** Keep a workflow copyable by placing its YAML, commands, and scripts together under `.archon\/workflows\/\/\/`; both directory names are yours. The same tree works in target repos and under `~\/.archon\/workflows\/`. Existing flat workflows and shared `.archon\/commands\/` \/ `.archon\/scripts\/` remain supported. Same-named workflow files in your repo override bundled defaults.\n\nSee [Authoring Workflows](https:\/\/archon.diy\/guides\/authoring-workflows\/) and [Authoring Commands](https:\/\/archon.diy\/guides\/authoring-commands\/).\n\n## Add a Platform\n\nThe Web UI and CLI work out of the box. Optionally connect a chat platform for remote access:\n\n| Platform | Setup time | Guide |\n|----------|-----------|-------|\n| **Telegram** | 5 min | [Telegram Guide](https:\/\/archon.diy\/adapters\/telegram\/) |\n| **Slack** | 15 min | [Slack Guide](https:\/\/archon.diy\/adapters\/slack\/) |\n| **GitHub Webhooks** | 15 min | [GitHub Guide](https:\/\/archon.diy\/adapters\/github\/) |\n| **Discord** | 5 min | [Discord Guide](https:\/\/archon.diy\/adapters\/community\/discord\/) |\n\n## Architecture\n\n```\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Platform Adapters (Web UI, CLI, Telegram, Slack, \u2502\n\u2502 Discord, GitHub) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Orchestrator \u2502\n\u2502 (Message Routing & Context Management) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502 \u2502\n \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n \u2502 \u2502 \u2502 \u2502\n \u25bc \u25bc \u25bc \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Command \u2502 \u2502 Workflow \u2502 \u2502 AI Assistant Clients \u2502\n\u2502 Handler \u2502 \u2502 Executor \u2502 \u2502 (Claude \/ Codex \/ Pi) \u2502\n\u2502 (Slash) \u2502 \u2502 (YAML) \u2502 \u2502 \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502 \u2502 \u2502\n \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 SQLite \/ PostgreSQL (14 core tables) \u2502\n\u2502 Codebases \u2022 Conversations \u2022 Sessions \u2022 Workflow Runs \u2502\n\u2502 Isolation Environments \u2022 Messages \u2022 Workflow Events \u2502\n\u2502 Users \u2022 User Identities \u2022 Workflow Node Sessions \u2502\n\u2502 Codebase Env Vars \u2022 User GitHub Tokens \u2502\n\u2502 User Provider Keys \u2022 User AI Prefs \u2502\n\u2502 (+ Better Auth tables, Postgres only) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## Documentation\n\nFull documentation is available at **[archon.diy\/docs](https:\/\/archon.diy\/docs\/)**.\n\n| Topic | Description |\n|-------|-------------|\n| [Getting Started](https:\/\/archon.diy\/getting-started\/overview\/) | Setup guide (Web UI or CLI) |\n| [The Book of Archon](https:\/\/archon.diy\/book\/) | 10-chapter narrative tutorial |\n| [CLI Reference](https:\/\/archon.diy\/reference\/cli\/) | Full CLI reference |\n| [Authoring Workflows](https:\/\/archon.diy\/guides\/authoring-workflows\/) | Create custom YAML workflows |\n| [Authoring Commands](https:\/\/archon.diy\/guides\/authoring-commands\/) | Create reusable AI commands |\n| [Configuration](https:\/\/archon.diy\/reference\/configuration\/) | All config options, env vars, YAML settings |\n| [AI Assistants](https:\/\/archon.diy\/getting-started\/ai-assistants\/) | Claude, Codex, and Pi setup details |\n| [Deployment](https:\/\/archon.diy\/deployment\/) | Docker, VPS, production setup |\n| [Architecture](https:\/\/archon.diy\/reference\/architecture\/) | System design and internals |\n| [Troubleshooting](https:\/\/archon.diy\/reference\/troubleshooting\/) | Common issues and fixes |\n\n**For AI tools:** Point your LLM at [`\/llms.txt`](https:\/\/archon.diy\/llms.txt) for an index of all documentation, [`\/llms-full.txt`](https:\/\/archon.diy\/llms-full.txt) for the complete docs in a single file, or [`\/llms-small.txt`](https:\/\/archon.diy\/llms-small.txt) for a condensed version.\n\n## Telemetry\n\nArchon sends a few anonymous events so maintainers can see which workflows get real usage, on what platforms, and whether runs succeed \u2014 and prioritize accordingly. **No PII, ever.** Events: `archon_started` (once per CLI invocation \/ server boot), `archon_active` (daily heartbeat while a server is running, so long-running installs stay counted), `chat_turn_handled` (each direct AI chat turn \u2014 platform, provider, model, duration, and usage totals; never message content), `workflow_invoked` (each workflow start), `workflow_completed` \/ `workflow_failed` (each run outcome), `workflow_approval_resolved` (each human approve\/reject decision \u2014 the binary resolution only, never comments or reasons), and `codebase_registered` (a pure count when a project is registered \u2014 no name, path, or URL).\n\n**What's collected (categorical only):**\n- **Workflow name** \u2014 the real name for *bundled* (Archon-authored) workflows; `\"custom\"` for your own workflows, so private names never leave your machine.\n- **Run shape & outcome** \u2014 platform (`cli`\/`web`\/`slack`\/\u2026), provider id (plus the model id on `workflow_invoked`), node count, which node types and features are used (loop\/approval\/script\/bash, structured output, persisted sessions, MCP, skills, fresh-context loops), success\/failure, duration, a categorical failure reason, and a fixed-enum failure class (`fatal`\/`transient`\/`unknown` \u2014 never raw error text) plus the failed node's type.\n- **Chat activity** \u2014 one event per direct-chat AI turn with platform, provider, model, duration, and completed\/failed. Message content, prompts, and conversation ids are never sent.\n- **Aggregate usage** \u2014 provider-reported token counts and cost (USD) per workflow run and chat turn, plus total loop iterations per run. Numeric totals only \u2014 never the content the tokens represent.\n- **Machine context** \u2014 OS, architecture, Archon version, runtime, whether it's a binary build, and a CI flag.\n- **Deployment shape** (server only) \u2014 which adapters are enabled (booleans), database kind (`sqlite`\/`postgresql`), whether web auth and multi-user mode are on, and the GitHub auth mode. Configuration *values* (tokens, URLs, hosts) are never sent.\n- A random install UUID stored at `~\/.archon\/telemetry-id`. Nothing else.\n\n**What's *not* collected:** your code, prompts, messages, custom workflow names, workflow descriptions, git remotes, file paths, usernames, tokens, AI output, error message text, your IP address, your geographic location \u2014 none of it.\n\n**Opt out:** set any of these in your environment:\n\n```bash\nARCHON_TELEMETRY_DISABLED=1\nDO_NOT_TRACK=1 # de facto standard honored by Astro, Bun, Prisma, Nuxt, etc.\nPOSTHOG_API_KEY=off # off | 0 | false | disabled | \"\" all disable\n```\n\nCI environments (`CI=true`) are auto-disabled \u2014 forks running fixtures in GitHub Actions, CircleCI, etc. do not send events.\n\n**Check the current state:** run `archon telemetry status` to see whether telemetry is enabled, why (if not), the install UUID, and the active host. Run `archon telemetry reset` to rotate the install UUID. `archon doctor` also surfaces the current state in its check list.\n\nSelf-host PostHog or use a different project by setting `POSTHOG_API_KEY` and `POSTHOG_HOST`.\n\n## Contributing\n\nContributions welcome! See the open [issues](https:\/\/github.com\/coleam00\/Archon\/issues) for things to work on.\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting a pull request.\n\n## Star History\n\n[![Star History Chart](https:\/\/api.star-history.com\/chart?repos=coleam00\/Archon&type=date&legend=top-left)](https:\/\/www.star-history.com\/?repos=coleam00%2FArchon&type=date&legend=top-left)\n\n## License\n\n[MIT](LICENSE)"},"categories":[2442],"tags":[1911,1987,1990,1993,1565,1996,2008,1574,1999,2002,2005,2011],"ai_series":[],"ai_topic":[2650],"ai_creator":[715],"ai_collection":[291],"ai_resource_type":[96],"ai_tool_tag":[],"class_list":["post-4146","post","type-post","status-publish","format-standard","hentry","category-product","tag-ai","tag-automation","tag-bun","tag-claude","tag-cli","tag-coding-assistant","tag-dag","tag-developer-tools","tag-typescript","tag-workflow-engine","tag-yaml","tag-2011","ai_topic-programming-development","ai_creator-coleam00","ai_collection-harness-agent-engineering","ai_resource_type-product"],"source_url":"","preserve_modified":false,"lang":"en","translations":{"en":4146,"zh-cn":65},"pll_sync_post":{},"_links":{"self":[{"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/posts\/4146","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/comments?post=4146"}],"version-history":[{"count":1,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/posts\/4146\/revisions"}],"predecessor-version":[{"id":4147,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/posts\/4146\/revisions\/4147"}],"wp:attachment":[{"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/media?parent=4146"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/categories?post=4146"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/tags?post=4146"},{"taxonomy":"ai_series","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_series?post=4146"},{"taxonomy":"ai_topic","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_topic?post=4146"},{"taxonomy":"ai_creator","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_creator?post=4146"},{"taxonomy":"ai_collection","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_collection?post=4146"},{"taxonomy":"ai_resource_type","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_resource_type?post=4146"},{"taxonomy":"ai_tool_tag","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_tool_tag?post=4146"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}