Documentation

Getting Started

Orchestrix provides AI-powered development agents through the MCP (Model Context Protocol). You can configure it with Claude Code or Cursor IDE in just a few steps.

Installation

Orchestrix connects directly to our cloud server. No local dependencies required, always up-to-date.

Claude Code

Option 1: Command Line

claude mcp add --transport http orchestrix https://orchestrix-mcp.youlidao.ai/api/mcp \
  --header "Authorization: Bearer YOUR_LICENSE_KEY"

Option 2: Configuration File

Add to ~/.claude.json (global) or .mcp.json (project):

{
  "mcpServers": {
    "orchestrix": {
      "type": "http",
      "url": "https://orchestrix-mcp.youlidao.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LICENSE_KEY"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "orchestrix": {
      "url": "https://orchestrix-mcp.youlidao.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LICENSE_KEY"
      }
    }
  }
}

Project Setup

Install Orchestrix infrastructure (slash commands, tmux scripts, hooks) into your project.

Option 1: CLI Installer (Recommended)

Run this command in your project directory:

npx orchestrix install

This installs everything in one command:

• .claude/commands/o.md, o-help.md, o-status.md — Slash Commands
• .mcp.json — MCP Server configuration (merged with existing)
• .orchestrix-core/core-config.yaml — Project configuration
• .orchestrix-core/scripts/ — tmux automation scripts (Pro/Team)
• .claude/settings.local.json — Claude Code hooks (Pro/Team)

Options: --key <KEY>, --offline, --force, --no-hooks, --no-scripts

Option 2: In-Session Installation (via Claude Code)

If you already have the MCP server connected, ask Claude directly:

Please call the orchestrix-init tool from the Orchestrix MCP server

Claude will call the orchestrix-init tool and create the files interactively.

Available Commands

After installation, these commands are available in Claude Code:

Usage

After configuration, restart Claude Code or Cursor to activate the MCP server.

Quick Start with Slash Commands

If you've installed the Slash Commands, simply type:

/o dev        # Activate Developer agent
/o sm         # Activate Scrum Master agent
/o qa         # Activate QA Engineer agent
/o architect  # Activate System Architect agent

Available Agents

Troubleshooting

/exit
claude