# @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

```bash
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

```bash
npx @aiox-squads/aiox-install
```

### Options

```bash
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:

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

### Direct Profile Selection

Skip the profile question by specifying it directly:

```bash
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.

```bash
# 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