internals

How the Archon Port Allocation System for Worktree Servers Enables Deterministic Multi-Instance Development

April 10, 2026 coleam00/Archon ↗

Archon allocates TCP ports for worktree-based servers by hashing the absolute worktree path with MD5 to generate a deterministic offset between 100-999, which is added to base port 3090 to produce a unique port in the 3190-4089 range.

The Archon framework (coleam00/Archon) implements a sophisticated runtime port allocation mechanism that eliminates manual port configuration when running multiple server instances from different git worktrees. This system automatically calculates a unique, deterministic port for each worktree directory, enabling parallel development

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:

curl -s "https://instagit.com/install.md"

Add to your MCP client configuration:

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}

Ask your agent:

"Use Instagit MCP to understand how coleam00/Archon works."

Works with

Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →