open-index/open-npm huggingface dataset:
npm package: @orchestrator-claude/cli
Description: Orchestrator CLI - Project scaffolding, migration and management
Latest version: 3.30.2

# @orchestrator-claude/cli

**Orchestrator CLI - Project scaffolding, migration and management**

Essential tool for bootstrapping and managing Orchestrator projects. Provides offline commands (`init`, `migrate`, `templates`) that create the project structure required by Claude Code (CLAUDE.md, `.claude/` directory, agents, skills) and API commands that delegate to the orchestrator REST API.

## Features

- **Offline Commands**: `init`, `migrate`, `templates` work without Docker — they scaffold the project structure that enables Claude Code + MCP integration
- **API Commands**: `workflow`, `status`, `agents` require the Docker container running
- **Lightweight**: < 5MB npm package
- **Docker-First**: Orchestration logic runs in `orchestrator/api` container; CLI handles scaffolding and management

## Installation

```bash
npm install -g @orchestrator-claude/cli
```

## Quick Start

```bash
# Create a new project (scaffolds CLAUDE.md, .claude/, agents, skills, docker-compose)
orchestrator init my-project

# Migrate an existing project to Orchestrator
orchestrator migrate ./existing-project

# Start the orchestrator API (requires Docker)
cd my-project
docker-compose up -d

# Check status
orchestrator status
```

## Commands

### Offline (no Docker required)

| Command | Description |
|---------|-------------|
| `init <project>` | Scaffold a new project with CLAUDE.md, `.claude/`, agents, skills, templates |
| `migrate <path>` | Add Orchestrator structure to an existing project |
| `templates list` | List available project templates |
| `templates info <name>` | Show template details |

### API (requires Docker)

| Command | Description |
|---------|-------------|
| `status` | Health check of the orchestrator API |
| `workflow list/start/status/advance/detect/create/types` | Workflow management |
| `agents list/info/create/get/delete` | Agent management |

## Architecture

```
CLI (this package)
├── Offline Commands (init, migrate, templates)
│   └── Bundled Templates (CLAUDE.md, .claude/, agents, skills)
├── API Commands (workflow, status, agents)
│   └── HTTP Client (axios → REST API)
└── Formatters (chalk, ora)

Docker Container (orchestrator/api)
├── Domain Logic
├── Application Services
├── Infrastructure (PostgreSQL, MinIO, Neo4j)
└── REST API Server
```

## Development

```bash
# Build
npm run build

# Test
npm test

# Coverage
npm run test:coverage
```

## License

MIT