CLI

Usage: aico [options] [command]
 
AI employee management tool - Build your AI team in seconds
 
Options:
  -V, --version        output version number
  -v, --verbose        show detailed error information
  --proxy <url>        use HTTP/HTTPS proxy for requests
  -h, --help           display help for command

npx aico init

Usage: aico init [options]
 
Initialize aico in your project
 
Options:
  -p, --default-platform <platform>  Default platform (claude-code, codex)
  -f, --force                        Overwrite existing configuration (default: false)
  -c, --cwd <cwd>                    Working directory (default: current directory)
  -h, --help                         display help for command

npx aico add [items...]

Usage: aico add [options] [items...]
 
Add employees or skills to your project
 
Arguments:
  items                     Employee or skill names (e.g., pm, @the-aico/pm/brainstorming)
 
Options:
  -p, --platform <platform>  Target platform (can be used multiple times)
  -o, --overwrite            Overwrite existing files (default: false)
  -y, --yes                  Skip confirmation prompts (default: false)
  --no-deps                  Skip dependency installation (default: false)
  -c, --cwd <cwd>            Working directory (default: current directory)
  -h, --help                 display help for command

# Add PM employee (shorthand)
npx aico add pm
 
# Add PM employee (full name)
npx aico add @the-aico/pm
 
# Add multiple employees
npx aico add pm frontend
 
# Add a single skill
npx aico add @the-aico/pm/brainstorming
 
# Add to specific platform
npx aico add pm -p codex
 
# Interactive mode
npx aico add

npx aico remove [items...]

Usage: aico remove [options] [items...]
 
Remove employees or skills from your project
 
Arguments:
  items                      Employee or skill names to remove
 
Options:
  -p, --platform <platform>  Remove from specific platform only
  -y, --yes                  Skip confirmation prompts (default: false)
  -f, --force                Force remove (ignore dependency warnings) (default: false)
  --dry-run                  Preview changes without removing (default: false)
  -c, --cwd <cwd>            Working directory (default: current directory)
  -h, --help                 display help for command

# Remove employee
npx aico remove pm
 
# Remove skill
npx aico remove @the-aico/pm/brainstorming
 
# Preview removal
npx aico remove pm --dry-run

npx aico list [options]

Usage: aico list [options]
 
List available or installed employees
 
Options:
  -i, --installed    Show only installed employees (default: false)
  -c, --cwd <cwd>    Working directory (default: current directory)
  -h, --help         display help for command

# List available employees from registry
npx aico list
 
# List installed employees only
npx aico list --installed

npx aico update [skills...]

Usage: aico update [options] [skills...]
 
Update installed skills to latest versions
 
Arguments:
  skills           Skill names to update (all if empty)
 
Options:
  --dry-run        Preview updates without applying (default: false)
  -y, --yes        Skip confirmation (default: false)
  -c, --cwd <cwd>  Working directory (default: current directory)
  -h, --help       display help for command

npx aico search <query>

Usage: aico search [options] <query>
 
Search for skills and employees
 
Arguments:
  query                    Search query
 
Options:
  -c, --category <category>  Filter by category (pm, frontend, backend)
  -t, --type <type>          Filter by type (skill, employee)
  --json                     Output as JSON
  --limit <n>                Limit results (default: 10)
  --cwd <cwd>                Working directory (default: current directory)
  -h, --help                 display help for command

# Search for brainstorming-related content
npx aico search brainstorm
 
# Search only in pm category
npx aico search story -c pm
 
# Output as JSON
npx aico search frontend --json

npx aico diff [employee]

Usage: aico diff [options] [employee]
 
Check for updates against the registry
 
Arguments:
  employee         Employee name to check (checks all if not specified)
 
Options:
  -c, --cwd <cwd>  Working directory (default: current directory)
  -h, --help       display help for command

# Check all employees for updates
npx aico diff
 
# Check specific employee with detailed diff
npx aico diff pm

npx aico check

Usage: aico check [options]
 
Check environment and configuration
 
Options:
  --json           Output as JSON
  --cwd <cwd>      Working directory (default: current directory)
  -h, --help       display help for command

npx aico build

Usage: aico build [options]
 
Build registry from employees directory
 
Options:
  -e, --employees-dir <dir>  Employees source directory (default: "employees")
  -o, --output-dir <dir>     Output directory (default: "registry")
  -r, --registry <name>      Registry namespace (default: "@the-aico")
  -v, --version <version>    Version number (default: "1.0.0")
  -c, --cwd <cwd>            Working directory (default: current directory)
  -h, --help                 display help for command

registry/
├── index.json                    # Legacy employee index
├── pm.json                       # Legacy PM employee data
├── frontend.json                 # Legacy Frontend employee data
├── backend.json                  # Legacy Backend employee data
├── employees/
│   ├── index.json                # Employee index
│   ├── pm.json                   # PM employee data
│   ├── frontend.json             # Frontend employee data
│   └── backend.json              # Backend employee data
└── skills/
    ├── index.json                # Skills index
    └── aico/
        ├── pm/
        │   ├── brainstorming.json
        │   └── ...
        ├── frontend/
        │   └── ...
        └── backend/
            └── ...