npm.io
3.0.0 • Published 2d agoCLI

@asno-dev/apex

Licence
MIT
Version
3.0.0
Deps
0
Size
288 kB
Vulns
0
Weekly
153
SummaryDependencyVersions

npm version npm downloads license agents tools adapters node

APEX

10-Agent Senior Engineering Team for Any CLI Coding Agent

A zero-dependency orchestrator that routes your requests to 10 specialist AI agents — each with domain expertise, purpose-built tools, and the ability to dynamically call peers mid-task. Works with 13 coding agents out of the box.

Agents • Installation • MCP Servers • Commands • Composio • Mirage VFS • License

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
.mcp.json — 3 MCP servers: apex-hands (56 tools), mirage-vfs (50+ backends), apex-composio (1000+ tools)
{
  "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
.claude/plugin.json — 10 subagents, 8 commands, 3 MCP servers, lifecycle hooks
{
  "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
.codex/plugin.json — 10 subagents, 3 MCP servers, skills
{
  "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
.gemini/gemini-extension.json — 8 commands, 3 MCP servers (agents auto-discovered from .gemini/agents/*.md)
{
  "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
.cursor/mcp.json — MCP + rules for 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
.cline/mcp.json — MCP + rules for 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
opencode.json — Plugin config with MCP servers
{
  "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
antigravity-extension.json — Extension for agy binary
{
  "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
.devin/plugin.json — 10 agents, 8 commands, 3 MCP servers
{
  "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
.hermes/plugin.json — 10 agents, 3 MCP servers, 8 commands
{
  "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
.pi/package.json — Pi extension with MCP servers
{
  "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
.openclaw/skills/manifest.json — 10 agent skills, 3 MCP servers
{
  "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
.github/copilot-instructions.md — Always-on instructions for Copilot CLI
# 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
.kilo/mcp.json — MCP + steering + agents for 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

License

MIT asno-dev

Follow on X • GitHub

Keywords

aicoding-agentclaude-codecursoropencodeclinegeminicodexantigravitycode-reviewdebuggingperformancesecurityarchitecture10-agentorchestratorapexmcpcomposiomiragesubagentscoding-assistant