Axis' Iliad

Axis' Iliad — The modern epic that shapes raw codebases into canonical, agent-ready artifacts. Axis' Iliad authors the definitive foundation for the next era of natural-language workspace development.

Canonical name: Axis' Iliad. Use this name consistently across docs, registries, and integrations.

AXIS Ecosystem

Iliad is the x402 showcase in the Trust Fabric stack. Full registry: packages/generator-core/src/estate-registry.ts, served live at GET /.well-known/axis-estate.json (superseding ecosystem.registry.yaml, retired 2026-08-22 — see docs/ESTATE_FEDERATION_STRATEGY.md).

x402 contract: docs/x402/CONTRACT.md

Try it in 30 seconds — no signup required

Every program ships free artifacts with no API key — 47 of the 152 in total. Three programs are free in full:

# 1. Get an API key (free tier, instant)
curl -X POST https://axis-api-6c7z.onrender.com/v1/accounts \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","name":"My Agent","tier":"free"}'

# 2. Analyze any public GitHub repo
curl -X POST https://axis-api-6c7z.onrender.com/v1/github/analyze \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"url":"https://github.com/owner/repo","programs":["search","skills","debug"]}'

# 3. Download the generated artifacts as a ZIP
curl https://axis-api-6c7z.onrender.com/v1/projects/PROJECT_ID/export \
  -H 'Authorization: Bearer YOUR_API_KEY' -o artifacts.zip

Free tier includes: 47 artifacts spanning all 21 programs — Search (context maps), Skills (AGENTS.md, CLAUDE.md, .cursorrules) and Debug (playbooks, incident templates) in full, plus each other program's headline artifact (design tokens, Dockerfile, MCP config, brand guidelines, ...). Paying unlocks each program's remaining artifacts.

What you get

One scan → 152 artifacts across 21 programs, ready in seconds:

Plus the begin loop — hand it to an agent and say begin

Every analysis also weaves in a self-driving control loop so an AI coding agent can finish the work, not just understand it:

• begin.yaml — the loop head: the inferred goal, a human-in-the-loop protocol (the owner only answers plain-English product questions), the move-selection algorithm, and convergent stop conditions.
• continuation.yaml — the loop state: an ordered step-list of every artifact + a priority candidate queue seeded from the analysis (the goal, detected gaps, a verify-harness when no tests exist).
• A ⟳ Continue footer on every Markdown artifact; the final step self-prompts begin, closing the loop back to begin.yaml.

Download the pack (CLI, MCP, or the full-pack export), hand it to an agent, say begin — it works the queue, verifies each step, and stops when the queue is empty (convergent, never a runaway). No coding required on the owner's end.

AXIS dogfoods this on itself: this repo's own root begin.yaml / continuation.yaml are the live loop we work from, also served verbatim over REST at GET /begin.yaml / GET /continuation.yaml — so an agent crawling this API discovers the same convention without cloning the repo.

For AI agents — MCP integration

AXIS exposes a Streamable HTTP MCP server at https://axis-api-6c7z.onrender.com/mcp. Add it to your agent and it can analyze any repo or prepare for agentic purchasing autonomously.

VS Code (.vscode/mcp.json):

{
  "servers": {
    "axis-iliad": {
      "type": "http",
      "url": "https://axis-api-6c7z.onrender.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "axis-iliad": {
      "url": "https://axis-api-6c7z.onrender.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Free MCP tools (no auth needed): list_programs, search_and_discover_tools, get_install_manifest, discover_agentic_purchasing_needs, prepare_agentic_purchasing_preview, discover_estate_tools (sibling AXIS properties — payments, 3D generation, and more), plus the deterministic commerce decision engines: sca_exemption_decision, grade_compliance, assemble_ce3_evidence, build_ap2_mandate, score_dispute_readiness (evidence-capture readiness — not a dispute-win prediction). Five more are estate-flagged planned-capability stubs (Foundry Wave-1, honest redirects to Foundry's own MCP endpoint until an Iliad-hosted proxy ships): axis_validate, axis_inspect, axis_compare, axis_manifest_verify, roblox_compliance_check. get_referral_code, get_referral_credits, and iliad_network_tokenization are also free (no charge) but, unlike the tools above, do require auth. ping_payment is not free — it costs $0.01 and exercises the real x402 payment loop, the cheapest paid call in the catalog.

Pricing

Budget negotiation: send X-Agent-Budget: {"budget_per_run_cents": 25} + X-Agent-Mode: lite on any paid call.

Self-host

System Requirements

• Node.js: ≥ 20.x (LTS recommended)
• pnpm: ≥ 9.x
• OS: macOS 11+, Linux (any distro), or Windows 10+
• RAM: 4 GB minimum (8 GB recommended)
• Disk space: ~2 GB for dependencies + build

Quick Start

# Prerequisites: Node.js ≥ 20, pnpm ≥ 9
git clone https://github.com/lastmanupinc-hub/axis-iliad.git
cd axis-iliad
pnpm install
pnpm build

# Start the API server (port 4000)
node apps/api/dist/server.js

# Start the web UI (port 5173)
cd apps/web && npx vite