@aiox-squads/aiox-install

NPX installer for AIOX - AI-Orchestrated System for Full Stack Development.

Successor to @synkra/aiox-install. Same installer, new canonical @aiox-squads/* namespace.

Quick Start

npx @aiox-squads/aiox-install

That's it! The installer will guide you through setting up AIOX in less than 5 minutes.

Features

• Cross-platform support: macOS, Windows (with WSL), and Linux
• Dependency checking: Verifies Node.js, Git, Docker, and GitHub CLI
• Profile selection: Choose between "bob" (simplified) or "advanced" mode
• Brownfield support: Detects existing AIOX installations and offers migration
• Dry-run mode: Preview what would be done without making changes

Usage

Interactive Installation

npx @aiox-squads/aiox-install

Options

npx @aiox-squads/aiox-install --help

Options:
  -v, --version         Output the current version
  --dry-run            Preview what would be done without making changes
  --verbose            Enable verbose output
  --profile <type>     Set profile directly (bob or advanced)
  --skip-deps          Skip dependency checking
  --no-color           Disable colored output
  -h, --help           Display help for command

Dry Run

Preview the installation without making any changes:

npx @aiox-squads/aiox-install --dry-run

Direct Profile Selection

Skip the profile question by specifying it directly:

npx @aiox-squads/aiox-install --profile bob
npx @aiox-squads/aiox-install --profile advanced

edmcp - Docker MCP Manager

The installer also includes edmcp, a CLI for managing MCPs in the Docker Gateway.

# List active MCPs
edmcp list

# Add an MCP
edmcp add exa
edmcp add https://github.com/user/my-mcp

# Remove an MCP
edmcp remove my-mcp

Requirements

• Node.js: >= 18.0.0 (required)
• Git: >= 2.30 (required)
• Docker: Optional (required for edmcp)
• GitHub CLI (gh): Optional (enhances workflow)

Profiles

Bob Mode (Default)

Simplified mode for new users. Only Bob is visible, orchestrating internally.

• Single interface through Bob
• Streamlined workflow
• Best for getting started quickly

Advanced Mode

Full access to all agents and commands.

• Access to all 11 agents (@dev, @qa, @architect, etc.)
• Full command palette
• Best for experienced users

Brownfield Migration

If you have an existing AIOX installation, the installer will:

1. Detect your current configuration
2. Offer to migrate to the new L1-L5 configuration hierarchy
3. Preserve your existing settings

Support

• Documentation: https://github.com/SynkraAI/aiox-core
• Issues: https://github.com/SynkraAI/aiox-core/issues

License

MIT