Open source Archon: migrate new codebase to coleam00/Archon

[coleam00]

Overview

Archon is evolving from a Python-based MCP knowledge/task management tool into a TypeScript workflow engine for AI coding agents. The new codebase (currently at dynamous-community/remote-coding-agent) will replace the old code in this repository.

The old Python code will be archived on a branch (archive/v1-python-mcp) so it remains accessible, but main and dev will contain the new TypeScript/Bun codebase going forward.

Why

Same vision (AI command center), completely new implementation. Keeping this repo preserves the community (13.8k+ stars), the name, and the momentum. The new Archon packages AI coding workflows as YAML files and runs them anywhere — CLI, Web UI, Slack, Telegram, GitHub, Discord.

Migration Checklist

Phase 1: Repository Migration

• Create archive/v1-python-mcp branch from current main
• Create archive/v1-stable branch from current stable
• Push new TypeScript codebase as main and dev
• Delete old feature branches (keep archive/*)
• Update repo description, homepage (archon.diy), and topics
• Close all existing issues with a comment explaining the migration

Phase 2: License & Reference Updates

• Change license from proprietary Dynamous to MIT
• Find-and-replace all dynamous-community/remote-coding-agent → coleam00/Archon (~56 occurrences)
• Update Docker image namespace: ghcr.io/dynamous-community/remote-coding-agent → ghcr.io/coleam00/archon
• Remove hardcoded local paths from .claude/skills/ and docs
• Update Homebrew formula URLs and move tap to coleam00/homebrew-archon
• Archive dynamous-community/remote-coding-agent as read-only

Phase 3: Windows Support

• Add Windows x64 binary to release pipeline (cross-compile from Linux)
• Create PowerShell install script (scripts/install.ps1)
• Update scripts/install.sh to point Windows/MINGW users to PowerShell installer
• Test Windows binary end-to-end

Phase 4: Custom Domain + Install URLs

• Configure archon.diy DNS (Cloudflare)
• Set up Cloudflare Worker for archon.diy/install → install.sh and archon.diy/install.ps1 → install.ps1
• Point archon.diy root to GitHub Pages (docs site)
• Verify: curl -fsSL https://archon.diy/install | bash works end-to-end
• Verify: irm https://archon.diy/install.ps1 | iex works end-to-end

Phase 5: Documentation Site (Astro Starlight)

• Scaffold Starlight docs site as docs/ workspace package (@archon/docs)
• Migrate existing docs/*.md content into Starlight pages
• Configure sidebar navigation, search, dark mode
• Add starlight-openapi plugin for API reference (from /api/openapi.json)
• Create splash/hero landing page at root
• Add .github/workflows/deploy-docs.yml for GitHub Pages deployment
• Configure GitHub Pages source → GitHub Actions
• Create docs/public/CNAME with archon.diy

Phase 6: GitHub Actions Updates

• Update release.yml — add Windows binary, update URLs, add --minify --bytecode
• Update publish.yml — new Docker image namespace
• Update test.yml — branch triggers (dev not develop)
• Add deploy-docs.yml — Starlight to GitHub Pages on main push
• Add auto Homebrew formula update on release

Phase 7: README & Public Launch Polish

• Overhaul README for public audience
• Add prominent installation section (curl, PowerShell, Homebrew, Docker)
• Add "Why Archon?" section
• Add badges: CI status, version, license, Docker pulls
• Remove all Dynamous community / beta references
• Link to archon.diy docs site
• Create CONTRIBUTING.md
• Create SECURITY.md
• Add GitHub issue templates
• Enable GitHub Discussions

Phase 8: Post-Migration

• Cut first public release (v0.2.12)
• Update Homebrew formula with real SHA256 checksums
• Verify all install methods work on all platforms
• Close/label remaining old issues
• Archive dynamous-community/remote-coding-agent

Install Methods (Target State)

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

# Windows (PowerShell)
irm https://archon.diy/install.ps1 | iex

# Homebrew (macOS / Linux)
brew install coleam00/archon/archon

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

# From source
git clone https://github.com/coleam00/Archon && cd Archon && bun install

Tech Stack (New Archon)

• Runtime: Bun + TypeScript
• Database: SQLite (default) / PostgreSQL (optional)
• Frontend: React 19 + Vite + Tailwind v4 + shadcn/ui
• AI: Claude Code SDK + Codex SDK
• Adapters: CLI, Web UI, Slack, Telegram, GitHub, Discord
• Docs: Astro Starlight at archon.diy

[coleam00]

Migration complete. New TypeScript codebase live on main/dev, docs at archon.diy, first release v0.2.13 published, Homebrew tap created. See #957 for the announcement.