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.

Try it in 30 seconds — no signup required

Three programs are completely free with no API key:

# 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: Search (context maps), Skills (AGENTS.md, CLAUDE.md, .cursorrules), Debug (playbooks, incident templates). Pro unlocks all 18 programs.

What you get

One scan → 99 artifacts across 18 programs, ready in seconds:

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, discover_commerce_tools, discover_agentic_purchasing_needs, get_referral_code, get_referral_credits

Pricing

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

Self-host

# 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

# Or use the CLI directly
node apps/cli/dist/cli.js analyze .
node apps/cli/dist/cli.js github https://github.com/owner/repo

Docker:

docker build -t axis-iliad .
docker run -p 4000:4000 axis-iliad

Architecture

axis-iliad/
├── apps/
│   ├── api/          → Zero-dependency HTTP server (port 4000, 102 endpoints)
│   ├── cli/          → CLI tool: axis analyze <dir> | axis github <url>
│   └── web/          → Vite + React 19 SPA (dark theme, toast, command palette)
├── packages/
│   ├── snapshots/    → Snapshot intake, SQLite persistence, billing, funnel
│   ├── repo-parser/  → Language detection (60+), framework detection (10), import graph
│   ├── context-engine/ → Context map builder, repo profile, route/architecture analysis
│   └── generator-core/ → 88 generators across 18 programs
└── vitest.config.ts  → Shared test config

Programs (18)

API Endpoints

Core Pipeline

Billing & Account

Funnel & Plans

Search & Versions

Webhooks

Infrastructure

Input Methods

1. File Upload — POST /v1/snapshots with multipart body
2. GitHub URL — POST /v1/github/analyze with { "url": "https://github.com/..." }
3. CLI (local) — axis analyze <directory> scans local files
4. CLI (remote) — axis github <url> fetches from GitHub

Tech Stack

• Runtime: Node.js 20+, TypeScript 5.7 strict
• Backend: Zero-dependency custom HTTP router, SQLite (better-sqlite3, WAL mode)
• Frontend: Vite 6 + React 19, CSS design system (dark theme)
• Testing: Vitest 4, 1485 tests across 68 files, 91.5% statement coverage
• Benchmarks: Vitest bench — parseRepo 200 files in 21ms, FTS5 search <0.2ms
• Build: pnpm workspaces, tsc per package
• CI: GitHub Actions (Node 20/22 matrix, coverage, dep audit, Docker build)

Development

pnpm install          # Install all dependencies
pnpm build            # Build all packages + apps
pnpm test             # Run all tests
npx vitest run        # Run tests directly
npx vitest bench      # Run performance benchmarks
npx vitest --coverage # Run tests with coverage report

See CONTRIBUTING.md for how to add a generator, endpoint, or program.

Input methods

Tech stack

• Runtime: Node.js 20+, TypeScript 5.7 strict
• Backend: Zero-dependency custom HTTP router, SQLite (better-sqlite3, WAL mode)
• Frontend: Vite 6 + React 19, CSS design system (dark theme)
• Testing: Vitest 4, 4076 tests across 140 files, 91.5% statement coverage
• Benchmarks: parseRepo 200 files in 21ms · FTS5 search <0.2ms
• Build: pnpm workspaces, tsc per package
• CI: GitHub Actions (Node 20/22 matrix, coverage, dep audit, Docker build)

Website: https://axis-iliad.jonathanarvay.com · Live API: https://axis-api-6c7z.onrender.com · Docs: https://axis-api-6c7z.onrender.com/v1/docs · MCP: https://axis-api-6c7z.onrender.com/mcp

License

Private. All rights reserved.