@asno-dev/apex

v3.2.9

Published

11 days ago

APEX v2 — 10-agent senior engineering team. Works with 12 coding agents: Claude Code, Codex, Gemini, Cursor, Cline, OpenCode, Antigravity, Devin, Hermes, Pi, OpenClaw, GitHub Copilot CLI.

🚀 Quick Start

npx @asno-dev/apex                       # Install shared APEX files (apex/ folder)
npx @asno-dev/apex claude-code            # Install for your coding agent

No auto-detection. No interactive prompts. You pick your agent, one command.

Then use @agentName in your coding agent:

@arch refactor this                → Max compresses your code
@ui build a login form             → Zara paints a WCAG AA form
@debug fix this error              → Kai runs 5-step debug protocol
@perf this is slow                 → Rex profiles & optimizes
@sec review auth code              → Vex scans for OWASP Top 10
@infra dockerize this              → Io outputs production-grade config
@nova any ideas?                   → Nova proposes non-obvious angles
@reed best caching strategy        → Dr. Reed compares options with evidence
@review check this code            → Rila gives structured PR review
@flex what's the MVP?              → Flex scores Value×Cost and cuts scope

🤖 Agents

APEX ships with 10 specialist agents, each with a unique persona, domain expertise, and set of purpose-built tools.

| Badge | Tag | Name | Role | Specialty | |:-----:|:---:|:----:|:-----|:----------| | [Arch] | @arch | Max | Architect | System design, refactoring, structure. Compresses 50→1 line. | | [UI] | @ui | Zara | UI/UX Designer | Mood-first, anti-slop. shadcn/ui + Tailwind. WCAG AA. 10 palettes. | | [Dbg] | @debug | Kai | Debugger | 5-step protocol: reproduce → isolate → hypothesize → fix → prevent. | | [Perf] | @perf | Rex | Performance Engineer | Profile first. Algorithm → DB → bundle → render. Baseline → optimize → measure. | | [Sec] | @sec | Vex | Security Engineer | OWASP Top 10. CRITICAL/HIGH/MEDIUM. Every input is malicious. | | [Inf] | @infra | Io | Infrastructure | Docker/k8s/CI-CD. Multi-stage builds. Non-root. Rollback always. | | [Nov] | @nova | Nova | Creative | Non-obvious angles. Lib + npm + POC + downside analysis. | | [Res] | @reed | Dr. Reed | Researcher | Evidence-based. ≥2 options with O(?) complexity. No opinions without data. | | [Rev] | @review | Rila | Code Reviewer | Blocking → Suggestions → Praise. Specific praise always. | | [Fnd] | @flex | Flex | Founder / PM | Value(1-3) × Cost(1-3). Ships 60%, defers 30%, kills 10%. |

Routing

| Your Request | Routed To | |:-------------|:----------| | Code is long/complex/messy | @arch | | Build UI / component / page | @ui | | Error / bug / crash / undefined | @debug | | Slow / memory / performance | @perf | | Auth / input / secrets / vuln | @sec | | Deploy / Docker / CI / k8s | @infra | | New idea / library / creative | @nova | | Best way / which / research | @reed | | Review / PR / merge / quality | @review | | Scope / MVP / what to build | @flex |

Modes

| Mode | Usage | Description | |:----:|:------|:------------| | Direct | @agent | That agent = main agent with full authority. Calls peers via @peerName. | | Team (default) | auto | Orchestrator routes to best agent. Agent calls peers dynamically. | | Select | /apex select a,b | Only those agents active until changed. |

Task States

🧠 Thinking  →  🔍 Exploring  →  ⚡ Working  →  🔧 Fixing  →  ✅ Verifying  →  ✨ Complete

📦 Installation

No auto-detection. No interactive picker. Three steps:

1. Install shared APEX files

npx @asno-dev/apex

Creates apex/ in your project with MCP servers, skills, agent definitions, and commands.

2. Copy the MCP config

{
  "mcpServers": {
    "apex-hands": {
      "command": ["node", "apex/src/hands-server.mjs"],
      "type": "local"
    },
    "mirage-vfs": {
      "command": ["node", "apex/src/mirage-server.mjs"],
      "type": "local"
    },
    "apex-composio": {
      "command": ["node", "apex/src/composio-server.mjs"],
      "type": "local"
    }
  }
}

3. Install for your coding agent

Choose your agent below. Each section shows the one-liner install and the files it creates.

Claude Code

npx @asno-dev/apex claude-code

{
  "name": "apex",
  "version": "2.0.0",
  "hooks": "./hooks.json",
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  },
  "subagents": ["agents/arch.md", "agents/ui.md", "agents/debug.md", "agents/perf.md", "agents/sec.md", "agents/infra.md", "agents/nova.md", "agents/reed.md", "agents/review.md", "agents/flex.md"],
  "commands": ["commands/apex.md", "commands/apex-docs.md", "commands/apex-excel.md", "commands/apex-ppt.md", "commands/apex-composio-setup.md", "commands/apex-composio-status.md", "commands/apex-composio-sync.md", "commands/apex-mirage.md"]
}

Installs: .claude/plugin.json, .claude/hooks.json, .claude/agents/ (10), .claude/commands/ (8), .claude/hooks/ (4)

Then: claude plugin install .claude

Codex CLI

npx @asno-dev/apex codex

{
  "name": "apex",
  "version": "3.0.0",
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  },
  "subagents": ["agents/arch.toml", "agents/ui.toml", "agents/debug.toml", "agents/perf.toml", "agents/sec.toml", "agents/infra.toml", "agents/nova.toml", "agents/reed.toml", "agents/review.toml", "agents/flex.toml"],
  "commands": ["apex", "apex-docs", "apex-excel", "apex-ppt", "apex-composio-setup", "apex-composio-status", "apex-composio-sync", "apex-mirage"]
}

Installs: .codex/plugin.json, .codex/mcp.toml, .codex/agents/ (10 .toml), .codex/SKILLS.md, commands/apex.md

Codex auto-loads .codex/plugin.json on startup. Zero setup.

Gemini CLI

npx @asno-dev/apex gemini

{
  "name": "apex",
  "version": "2.0.0",
  "mcpServers": {
    "apex-hands": { "command": "node apex/src/hands-server.mjs", "type": "local" },
    "mirage-vfs": { "command": "node apex/src/mirage-server.mjs", "type": "local" },
    "apex-composio": { "command": "node apex/src/composio-server.mjs", "type": "local" }
  },
  "commands": [
    {"name": "apex", "file": "commands/apex.md"},
    {"name": "apex-team", "file": "commands/apex.md"},
    {"name": "apex-docs", "file": "commands/apex-docs.md"},
    {"name": "apex-excel", "file": "commands/apex-excel.md"},
    {"name": "apex-ppt", "file": "commands/apex-ppt.md"},
    {"name": "apex-composio-setup", "file": "commands/apex-composio-setup.md"},
    {"name": "apex-composio-status", "file": "commands/apex-composio-status.md"},
    {"name": "apex-composio-sync", "file": "commands/apex-composio-sync.md"},
    {"name": "apex-mirage", "file": "commands/apex-mirage.md"}
  ]
}

Installs: .gemini/gemini-extension.json, .gemini/agents/ (10 .md), .gemini/commands/ (8 .md)

Then: gemini extensions install .gemini (installs from .gemini/gemini-extension.json)

Cursor

npx @asno-dev/apex cursor

{
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  }
}

Installs: .cursor/mcp.json, .cursor/rules/apex.mdc, .cursor/agents/ (10 .mdc), .cursor/commands/ (8 .md)

Auto-detects — Cursor loads .cursor/mcp.json and .cursor/rules/apex.mdc on project open. Zero setup.

Cline / Kilo

npx @asno-dev/apex cline

{
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  }
}

Installs: .cline/mcp.json, .cline/rules/apex.mdc, .cline/agents/ (10 .mdc), .cline/commands/ (8 .md), .clinerules

Auto-detects — Cline loads .cline/ config on project open. Zero setup.

OpenCode

npx @asno-dev/apex opencode

{
  "plugin": ["./adapters/opencode/apex.mjs"],
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"] },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"] },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"] }
  }
}

Installs: opencode.json, adapters/opencode/apex.mjs, .opencode/agents/ (10)

Auto-detects — OpenCode loads opencode.json and .opencode/agents/ on startup. Zero setup.

Antigravity CLI

npx @asno-dev/apex antigravity

{
  "name": "apex",
  "version": "3.0.0",
  "contextFileName": "AGENTS.md",
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  },
  "subagents": {
    "arch": { "name": "Max", "role": "Architect" },
    "ui": { "name": "Zara", "role": "UI/UX Designer" },
    "debug": { "name": "Kai", "role": "Debugger" },
    "perf": { "name": "Rex", "role": "Performance Engineer" },
    "sec": { "name": "Vex", "role": "Security Engineer" },
    "infra": { "name": "Io", "role": "Infrastructure Engineer" },
    "nova": { "name": "Nova", "role": "Creative" },
    "reed": { "name": "Dr.Reed", "role": "Researcher" },
    "review": { "name": "Rila", "role": "Reviewer" },
    "flex": { "name": "Flex", "role": "Founder/PM" }
  },
  "commands": ["apex", "docs", "excel", "ppt", "composio-setup", "composio-status", "composio-sync", "mirage"],
  "features": { "modes": ["direct", "team", "select"], "composio": true, "mirage": true, "officecli": true }
}

Installs: antigravity-extension.json, AGENTS.md

Auto-detects — Antigravity scans for antigravity-extension.json on startup. Zero setup.

Devin CLI

npx @asno-dev/apex devin

{
  "name": "apex",
  "version": "2.0.0",
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  },
  "agents": [
    {"name": "arch", "file": "agents/arch.md", "tag": "@arch"},
    {"name": "ui", "file": "agents/ui.md", "tag": "@ui"},
    {"name": "debug", "file": "agents/debug.md", "tag": "@debug"},
    {"name": "perf", "file": "agents/perf.md", "tag": "@perf"},
    {"name": "sec", "file": "agents/sec.md", "tag": "@sec"},
    {"name": "infra", "file": "agents/infra.md", "tag": "@infra"},
    {"name": "nova", "file": "agents/nova.md", "tag": "@nova"},
    {"name": "reed", "file": "agents/reed.md", "tag": "@reed"},
    {"name": "review", "file": "agents/review.md", "tag": "@review"},
    {"name": "flex", "file": "agents/flex.md", "tag": "@flex"}
  ],
  "commands": [
    {"name": "apex", "file": "commands/apex.md"},
    {"name": "apex-docs", "file": "commands/apex-docs.md"},
    {"name": "apex-excel", "file": "commands/apex-excel.md"},
    {"name": "apex-ppt", "file": "commands/apex-ppt.md"},
    {"name": "apex-composio-setup", "file": "commands/apex-composio-setup.md"},
    {"name": "apex-composio-status", "file": "commands/apex-composio-status.md"},
    {"name": "apex-composio-sync", "file": "commands/apex-composio-sync.md"},
    {"name": "apex-mirage", "file": "commands/apex-mirage.md"}
  ]
}

Installs: .devin/plugin.json, .devin/agents/ (10 .md), .devin/commands/ (8 .md)

Auto-detects — Devin reads .devin/ config on startup. Zero setup.

Hermes Agent

npx @asno-dev/apex hermes

{
  "name": "apex",
  "version": "2.0.0",
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  },
  "agents": [
    {"name": "arch", "file": "agents/arch.md", "tag": "@arch"},
    {"name": "ui", "file": "agents/ui.md", "tag": "@ui"},
    {"name": "debug", "file": "agents/debug.md", "tag": "@debug"},
    {"name": "perf", "file": "agents/perf.md", "tag": "@perf"},
    {"name": "sec", "file": "agents/sec.md", "tag": "@sec"},
    {"name": "infra", "file": "agents/infra.md", "tag": "@infra"},
    {"name": "nova", "file": "agents/nova.md", "tag": "@nova"},
    {"name": "reed", "file": "agents/reed.md", "tag": "@reed"},
    {"name": "review", "file": "agents/review.md", "tag": "@review"},
    {"name": "flex", "file": "agents/flex.md", "tag": "@flex"}
  ],
  "commands": [
    {"name": "apex", "file": "commands/apex.md"},
    {"name": "apex-docs", "file": "commands/apex-docs.md"},
    {"name": "apex-excel", "file": "commands/apex-excel.md"},
    {"name": "apex-ppt", "file": "commands/apex-ppt.md"},
    {"name": "apex-composio-setup", "file": "commands/apex-composio-setup.md"},
    {"name": "apex-composio-status", "file": "commands/apex-composio-status.md"},
    {"name": "apex-composio-sync", "file": "commands/apex-composio-sync.md"},
    {"name": "apex-mirage", "file": "commands/apex-mirage.md"}
  ]
}

Installs: .hermes/plugin.json, .hermes/agents/ (10 .md), .hermes/commands/ (8 .md)

Then: hermes plugins install apex

Pi Agent Harness

npx @asno-dev/apex pi

{
  "name": "apex",
  "version": "2.0.0",
  "main": "index.js",
  "pi": {
    "mcpServers": {
      "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"] },
      "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"] },
      "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"] }
    },
    "agents": ["arch", "ui", "debug", "perf", "sec", "infra", "nova", "reed", "review", "flex"],
    "commands": ["apex", "apex-docs", "apex-excel", "apex-ppt", "apex-composio-setup", "apex-composio-status", "apex-composio-sync", "apex-mirage"],
    "features": { "modes": ["direct", "team", "select"], "composio": true, "mirage": true, "officecli": true }
  }
}

Installs: .pi/package.json, .pi/index.js, .pi/agents/ (10 .md), .pi/commands/ (8 .md)

Auto-detects — Pi loads .pi/ extensions on project trust. Zero setup.

OpenClaw

npx @asno-dev/apex openclaw

{
  "name": "apex",
  "version": "2.0.0",
  "skills": ["arch", "ui", "debug", "perf", "sec", "infra", "nova", "reed", "review", "flex"],
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"] },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"] },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"] }
  }
}

Installs: .openclaw/skills/manifest.json, .openclaw/skills/ (10), .openclaw/commands/ (8 .md)

Auto-detects — OpenClaw loads .openclaw/skills/ on project open. Zero setup.

GitHub Copilot CLI

npx @asno-dev/apex copilot

# APEX v2 — 10-Agent Senior Engineering Team

@arch Max (Architect) | @ui Zara (UI/UX) | @debug Kai (Debugger)
@perf Rex (Performance) | @sec Vex (Security) | @infra Io (Infra)
@nova Nova (Creative) | @reed Dr.Reed (Research) | @review Rila (Review)
@flex Flex (Founder/MVP)

## MCP Servers
- apex-hands: node apex/src/hands-server.mjs
- mirage-vfs: node apex/src/mirage-server.mjs
- apex-composio: node apex/src/composio-server.mjs

Installs: .github/copilot-instructions.md, .copilot/plugin.json, .copilot/agents/ (10 .md), .copilot/commands/ (8 .md)

Then: copilot plugin marketplace add asno-dev/apex then copilot plugin install apex

KiloCode / Kiro

npx @asno-dev/apex kilocode

{
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  }
}

Installs: .kilo/mcp.json, .kilo/steering/apex.md, .kilo/agents/ (10 .md), .kilo/commands/ (8 .md)

Auto-detects — KiloCode (kilo binary) loads .kilo/ config on project open. Zero setup.

⌨️ Commands

| Command | Description | |:--------|:------------| | apex-docs | Create/edit Word documents via OfficeCLI | | apex-excel | Create/edit Excel spreadsheets via OfficeCLI | | apex-ppt | Create PowerPoint presentations via OfficeCLI | | node apex/src/composio-setup.mjs | Connect external tools — paste API key, get OAuth link | | node apex/src/composio-status.mjs | Show connected tools and API key status | | node apex/src/composio-status.mjs --sync | Force sync from Composio backend | | apex-mirage <command> | Execute commands across mounted virtual filesystem backends | | /apex-team | Full team mode — all 10 agents work together end-to-end | | /apex team\|select\|off\|status\|help | APEX mode control |

🔧 MCP Servers

APEX provides 3 MCP (Model Context Protocol) servers with 56 purpose-built tools across all 10 agents, plus 6 virtual filesystem tools and 1000+ external tool bridges.

1. apex-hands — 56 Agent Domain Tools

| Agent | Tools | |:------|:------| | @arch | blast_radius dep_graph complexity extract_refactor compose_check module_boundary | | @ui | contrast palette_extract a11y_audit responsive_test component_search | | @debug | reproduce stack_walk log_mine bisect_run guard_inject var_watch | | @perf | profile memory_profile baseline_capture measure bundle_analyze big_o | | @sec | vuln_scan secret_find input_trace auth_map owasp_score dependency_audit | | @infra | docker_lint k8s_validate ci_check deploy_dry rollback_plan health_check | | @nova | poc_gen lib_compass alt_angle trend_sniff downside_check approach_matrix | | @reed | compare complexity_calc evidence_search tradeoff_matrix recommend | | @review | diff_cat anti_pattern quality_gate praise_find review_card | | @flex | value_cost mvp_cut risk_matrix roadmap effort_estimate |

2. mirage-vfs — Virtual Filesystem (50+ Backends)

Unified filesystem across S3, GDrive, Slack, Redis, Postgres, and more.

Setup: pip install mirage-ai && npm install -g @struktoai/mirage-cli

Usage:

apex-mirage ls /s3/                    — List files in S3 bucket
apex-mirage cp /gdrive/report.pdf /data/  — Copy from Google Drive
apex-mirage grep -r error /s3/logs/    — Search across backends

3. apex-composio — 1000+ External Tool Bridge

Bridges Gmail, GitHub, Slack, Jira, Notion, and 1000+ more tools.

Setup: node apex/src/composio-setup.mjs

Usage: @gmail send email | @github create PR | @slack post message

All 3 MCP Servers in One Config

{
  "mcpServers": {
    "apex-hands": { "command": ["node", "apex/src/hands-server.mjs"], "type": "local" },
    "mirage-vfs": { "command": ["node", "apex/src/mirage-server.mjs"], "type": "local" },
    "apex-composio": { "command": ["node", "apex/src/composio-server.mjs"], "type": "local" }
  }
}

🔗 Agent Chains

Sequential

Full app:        @arch → @ui → @infra      # Design → Paint → Deploy
Bug patch:       @debug → @review           # Fix → Verify
Spec to code:    @flex → @arch → @ui        # Scope → Design → Build

Parallel

System design:   @arch ∥ @reed              # Architecture + Research in parallel

Dynamic Peer Calling

@perf finds SQL injection → calls @sec
@ui needs a backend API → calls @infra
@debug finds performance issue → calls @perf
@review finds security concern → calls @sec

🎨 Design System (Zara)

10 curated palettes: Trust, Energy, Authority, Clarity, Warmth, Midnight, Forest, Ocean, Aurora, Minimal
CSS variable tokens for all colors as :root variables
2 fonts max per project
shadcn/ui component library + Tailwind CSS scale
WCAG AA compliance (4.5:1 contrast ratio minimum)
Mobile-first responsive design
200ms max transition duration
Semantic HTML throughout

Anti-Slop Rules

No decorative elements without purpose
No inline styles
No hardcoded hex colors
No gradients without justification
No ALL CAPS text

📋 Requirements

Node.js ≥ 18.0.0
At least one supported coding agent installed

Zero Dependencies

APEX has zero production dependencies. It uses only Node.js built-in modules.

🧪 Development

git clone https://github.com/asno-dev/apex.git
cd apex
npm test

Project Structure

| Directory | Purpose | |:----------|:--------| | adapters/ | Per-agent config files (13 agents) | | agents/ | Canonical agent definitions (10 agents) | | commands/ | Canonical command definitions (8 commands) | | skills/ | SKILL.md files for orchestrator and agents | | src/ | MCP servers and tool implementations | | hooks/ | Lifecycle hooks for session management | | bin/ | CLI entry point |