AICO - AI Employee Framework

Prerequisites

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

Quick Start

Initialize aico in your project:

npx 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:

npx 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:

npx aico add @the-aico/pm/brainstorming

Verify Installation

List installed employees:

npx 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

Installation