Installation

Prerequisites

• Node.js 18.17 or higher (20+ recommended)
• Claude Code or Codex CLI

Install CLI (Recommended)

We recommend installing aico globally for the best experience:

After installation, you can use the aico command directly:

aico --version

Using without Installation

If you prefer not to install globally, you can use your package manager's executor:

For example: npx @the-aico/cli list --remote

Note: Global installation provides a cleaner command experience. Choose whichever method you prefer.

Quick Start

Initialize aico in your project:

aico init

This creates an aico.json configuration file:

{
  "$schema": "https://the-aico.com/schema/config.json",
  "defaultPlatform": "claude-code",
  "platforms": {
    "claude-code": {
      "skills": ".claude/skills",
      "commands": ".claude/commands"
    }
  },
  "employees": {},
  "registries": {
    "@the-aico": "https://the-aico.com/r/{name}.json"
  }
}

Add an Employee

Add an AI employee to your project:

aico add @the-aico/pm

This installs all skills and commands for the PM employee.

Add a Single Skill

You can also install individual skills:

aico add @the-aico/pm/brainstorming

Verify Installation

List installed employees:

aico list

Output:

Installed employees:
 
@the-aico/pm (v1.0.0)
  ├── 8 skills
  └── 3 commands
 
Total: 1 employee, 8 skills, 3 commands

Directory Structure

After installation, your project will have:

your-project/
├── .claude/
│   ├── skills/
│   │   └── aico-pm-brainstorming/
│   │       └── SKILL.md
│   └── commands/
│       └── pm.plan.md
└── aico.json

Next Steps

• Browse available employees
• Learn the CLI commands
• Create your own custom skills