@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

npm install -g @orchestrator-claude/cli

Quick Start

# 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

# Build
npm run build

# Test
npm test

# Coverage
npm run test:coverage

License

MIT