AXIS iliad
Creates canvas specifications, social media packs, poster layouts, and visual asset guidelines for design and content creation.
Analyzes public GitHub repositories to generate context maps, agent-ready artifacts, and various program outputs across 18 different categories.
Generates Obsidian skill packs, vault rules, graph prompt maps, and other artifacts for managing knowledge vaults and note-taking systems.
Provides agentic purchasing capabilities including playbooks, checkout flows, and negotiation rules for Visa AP2 commerce integration.
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.zipFree 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 → 102 artifacts across 18 programs, ready in seconds:
What you need | Program | Key outputs |
Orient a new AI agent | Search (free) |
|
Give any LLM codebase context | Skills (free) |
|
Debug a production incident | Debug (free) |
|
Audit your UI | Frontend |
|
Fix search ranking | SEO |
|
Cut LLM costs | Optimization |
|
Ship a design system | Theme |
|
Unify your brand voice | Brand |
|
Automate dev workflows | Superpowers |
|
Launch a campaign | Marketing |
|
Build data/research tools | Notebook |
|
Manage a knowledge vault | Obsidian |
|
Connect AI tools (MCP) | MCP |
|
Generate components | Artifacts |
|
Create dev videos | Remotion |
|
Social & visual assets | Canvas |
|
Generative art / NFT | Algorithmic |
|
Agentic commerce (Visa AP2) | Agentic Purchasing |
|
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
Tier | Price | Programs |
Free | $0 | Search, Skills, Debug |
Pro | $0.50 / run | All 18 programs, 102 artifacts |
Lite mode | $0.15–$0.25 / run | Top-gap summary, reduced output |
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
# Or use the CLI directly
node apps/cli/dist/cli.js analyze .
node apps/cli/dist/cli.js github https://github.com/owner/repoDocker
docker build -t axis-iliad .
docker run -p 4000:4000 axis-iliadRequires: Docker 20.10+ or Docker Desktop
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/ → 102 generators across 18 programs
└── vitest.config.ts → Shared test configPrograms (18)
Program | Outputs | Tier |
Search | context-map.json, repo-profile.yaml, architecture-summary.md, dependency-hotspots.md | Free |
Skills | AGENTS.md, CLAUDE.md, .cursorrules, workflow-pack.md, policy-pack.md | Free |
Debug | debug-playbook.md, incident-template.md, tracing-rules.md, root-cause-checklist.md | Free |
Frontend | frontend-rules.md, component-guidelines.md, layout-patterns.md, ui-audit.md | Pro |
SEO | seo-rules.md, schema-recommendations.json, route-priority-map.md, content-audit.md, meta-tag-audit.json | Pro |
Optimization | optimization-rules.md, prompt-diff-report.md, cost-estimate.json, token-budget-plan.md | Pro |
Theme | design-tokens.json, theme.css, theme-guidelines.md, component-theme-map.json, dark-mode-tokens.json | Pro |
Brand | brand-guidelines.md, voice-and-tone.md, content-constraints.md, messaging-system.yaml, channel-rulebook.md | Pro |
Superpowers | superpower-pack.md, workflow-registry.json, test-generation-rules.md, refactor-checklist.md, automation-pipeline.yaml | Pro |
Marketing | campaign-brief.md, funnel-map.md, sequence-pack.md, cro-playbook.md, ab-test-plan.md | Pro |
Notebook | notebook-summary.md, source-map.json, study-brief.md, research-threads.md, citation-index.json | Pro |
Obsidian | obsidian-skill-pack.md, vault-rules.md, graph-prompt-map.json, linking-policy.md, template-pack.md | Pro |
MCP | mcp-config.json, mcp-registry-metadata.json, protocol-spec.md, connector-map.yaml, capability-registry.json, server-manifest.yaml | Pro |
Artifacts | generated-component.tsx, dashboard-widget.tsx, embed-snippet.ts, artifact-spec.md, component-library.json | Pro |
Remotion | remotion-script.ts, scene-plan.md, render-config.json, asset-checklist.md, storyboard.md | Pro |
Canvas | canvas-spec.json, social-pack.md, poster-layouts.md, asset-guidelines.md, brand-board.md | Pro |
Algorithmic | generative-sketch.ts, parameter-pack.json, collection-map.md, export-manifest.yaml, variation-matrix.json | Pro |
Agentic Purchasing | agent-purchasing-playbook.md, product-schema.json, checkout-flow.md, negotiation-rules.md, commerce-registry.json | Pro |
API Endpoints
Core Pipeline
Method | Path | Description |
POST |
| Upload repo snapshot (multipart file upload) |
POST |
| Analyze repo from GitHub URL |
GET |
| Get snapshot metadata |
GET |
| List snapshots for project |
POST |
| Run search program |
POST |
| Run skills program |
POST |
| Run debug program |
POST |
| Run frontend program |
POST |
| Run SEO program |
POST |
| Run optimization program |
POST |
| Run theme program |
POST |
| Run brand program |
POST |
| Run superpowers program |
POST |
| Run marketing program |
POST |
| Run notebook program |
POST |
| Run obsidian program |
POST |
| Run MCP program |
POST |
| Run artifacts program |
POST |
| Run remotion program |
POST |
| Run canvas program |
POST |
| Run algorithmic program |
POST |
| Run agentic purchasing program |
GET |
| List all programs with generator counts |
GET |
| Download individual generated file |
GET |
| Download ZIP of generated files |
Billing & Account
Method | Path | Description |
POST |
| Create account |
GET |
| Get account info |
POST |
| Create API key |
GET |
| List API keys |
POST |
| Revoke API key |
GET |
| Get usage stats |
GET |
| Get quota info |
POST |
| Update billing tier |
POST |
| Update program entitlements |
POST |
| Save encrypted GitHub token |
GET |
| List GitHub tokens |
DELETE |
| Delete GitHub token |
GET |
| Billing tier change audit trail |
GET |
| Proration preview for tier changes |
Funnel & Plans
Method | Path | Description |
GET |
| Get plan catalog |
POST |
| Invite team member |
GET |
| List team seats |
POST |
| Revoke seat |
GET |
| Get contextual upgrade prompts |
GET |
| Get funnel stage |
GET |
| Aggregate funnel analytics |
Search & Versions
Method | Path | Description |
POST |
| Index snapshot content for FTS5 search |
POST |
| Full-text search across indexed content |
GET |
| Search index statistics |
GET |
| List generation versions |
GET |
| Get specific version with files |
GET |
| Diff between two versions |
Webhooks
Method | Path | Description |
POST |
| Create webhook |
GET |
| List webhooks |
DELETE |
| Delete webhook |
POST |
| Toggle webhook active/disabled |
GET |
| List delivery attempts |
Infrastructure
Method | Path | Description |
GET |
| Health check |
GET |
| Liveness probe |
GET |
| Readiness probe (DB connectivity) |
GET |
| Prometheus-style metrics |
GET |
| Database statistics |
POST |
| Database maintenance (vacuum, WAL checkpoint) |
GET |
| OpenAPI 3.1 specification |
GET |
| System-wide statistics |
GET |
| Admin: list all accounts |
GET |
| Admin: recent activity feed |
Input Methods
File Upload — POST
/v1/snapshotswith multipart bodyGitHub URL — POST
/v1/github/analyzewith{ "url": "https://github.com/..." }CLI (local) —
axis analyze <directory>scans local filesCLI (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 reportSee CONTRIBUTING.md for how to add a generator, endpoint, or program.
Input methods
Method | How |
GitHub URL |
|
File upload |
|
CLI (local) |
|
CLI (remote) |
|
MCP |
|
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:
parseRepo200 files in 21ms · FTS5 search <0.2msBuild: 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.
This server cannot be installed
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/lastmanupinc-hub/AXIS-iliad'
If you have feedback or need assistance with the MCP directory API, please join our Discord server