AIOX Teams

Multi-agent orchestration MCP server for Claude Code. 12 specialized AI agents, 100+ task aliases, authority enforcement, and parallel agent execution — all through a single npx command.

Quick Start

npx aiox-teams init    # auto-registers via `claude mcp add`
# Restart Claude Code to load the MCP server

Or register manually:

claude mcp add aiox-teams -- npx -y aiox-teams@latest serve

What It Does

• 12 specialized agents (dev, qa, devops, architect, pm, po, sm, analyst, data-engineer, ux-design-expert, squad-creator, aiox-master) with strict authority boundaries
• 100+ task aliases that resolve to the right agent automatically (e.g., develop, qa-gate, push, brainstorm, db-audit)
• Parallel agent execution via aiox_build_agent_prompt + Claude Code's native Agent tool

Usage

After npx aiox-teams init, use the AIOX tools in Claude Code:

| What you want | Command | |---|---| | Implement a story | aiox(task: "develop", story: "path/to/story.md") | | QA review | aiox(task: "qa-gate", story: "path/to/story.md") | | Create a story | aiox(task: "create-story") | | Push to remote | aiox(task: "push") | | Brainstorm | aiox(task: "brainstorm") | | DB schema audit | aiox(task: "db-audit") | | See what's available | aiox_status() |

Modes

| Mode | Detected by | Description | |------|-------------|-------------| | Standalone | No .aiox-core/ directory | Uses 12 embedded agents with hardcoded prompts | | Linked | .aiox-core/ present | Reads agent definitions and tasks from your AIOX framework files |

Agents

| Name | Persona | Domain | Model | |------|---------|--------|-------| | dev | Dex | Implementation, debugging, tests | sonnet | | qa | Quinn | Code review, QA gates, verdicts | sonnet | | devops | Gage | git push, PRs, CI/CD, releases | sonnet | | architect | Aria | System architecture, tech selection | opus | | pm | Morgan | PRDs, epics, requirements | opus | | po | Pax | Story validation, backlog | sonnet | | sm | River | Story creation | sonnet | | analyst | Atlas | Research, brainstorming | opus | | data-engineer | Dara | Schema, migrations, RLS | sonnet | | ux-design-expert | Uma | Wireframes, UI analysis | sonnet | | squad-creator | Craft | Agent squad design | sonnet | | aiox-master | Orion | Orchestration, routing | opus |

Configuration

Environment Variables

| Variable | Description | |----------|-------------| | AIOX_AGENTS_DIR | Path to agent definition files (auto-set in linked mode) | | AIOX_TASKS_DIR | Path to task definition files |

MCP Registration

aiox-teams init tries claude mcp add first (Claude Code). Falls back to .mcp.json for other MCP clients (Cursor, Windsurf).

CLI Commands

aiox-teams init     # Configure AIOX Engine in current project
aiox-teams serve    # Start MCP server (stdio)
aiox-teams status   # Show engine mode and stats

Prerequisites

• Node.js >= 18
• Build tools for native modules (better-sqlite3):
  • macOS: Xcode Command Line Tools (xcode-select --install)
  • Linux: build-essential package
  • Windows: Visual Studio Build Tools

License

MIT