# Launch the interactive wizard
npx @ensemble-edge/ensemble

# Or run specific commands
npx @ensemble-edge/ensemble conductor init my-project
npx @ensemble-edge/ensemble conductor --help

ensemble conductor init my-project
ensemble conductor dev
ensemble conductor validate

ensemble conductor init [project-name]

# Interactive wizard (recommended)
ensemble conductor init my-project

# With examples (full template)
ensemble conductor init my-project --setup full

# Without examples (starter template)
ensemble conductor init my-project --setup starter
ensemble conductor init my-project --no-examples

# Minimal setup (basic)
ensemble conductor init my-project --setup basic

# Non-interactive (CI/CD mode)
ensemble conductor init my-project --yes

# With specific package manager
ensemble conductor init my-project --pm pnpm

# Force overwrite existing directory
ensemble conductor init my-project --force -y

ensemble configure [subcommand]

# Interactive menu
ensemble configure

# Configure AI directly
ensemble configure ai

# Pre-select provider
ensemble configure ai --provider anthropic

# Configure Cloudflare authentication
ensemble configure auth

ensemble conductor info [options]

┌─────────────────────┐
│ 🎼 Conductor Info   │
└─────────────────────┘

Project
  Name:             my-project
  Version:          1.2.3
  Conductor:        @ensemble-edge/[email protected]
  Environment:      development (local)

Configuration
  conductor.config: ✓ Found
  wrangler.toml:    ✓ Found

Components
  Agents:           12 (10 custom)
  Ensembles:        5
  Other:            30 (8 prompts, 6 schemas, 5 configs, ...)

Triggers
  HTTP routes:      8
  Webhooks:         2
  MCP tools:        3
  Cron jobs:        1

Security
  requireAuth:      ✓ true
  stealthMode:      ○ false
  allowDirectAgentExecution: ✓ true

┌─────────────────────────┐
│ ☁️  Cloudflare Services │
└─────────────────────────┘

AI & Intelligence
  ✓ Workers AI:       Configured              [AI]
  ○ AI Gateway:       Not configured
  ✓ Vectorize:        my-index                [VECTORIZE]

Storage
  ✓ KV:               2 configured            [CACHE, SESSIONS]
  ✓ D1:               my-db                   [DB]
  ○ R2:               Not configured

Compute & State
  ✓ Durable Objects:  2 configured            [EXEC, HITL]
  ○ Queues:           Not configured
  ○ Hyperdrive:       Not configured

┌───────────────┐
│ 🌐 Deployment │
└───────────────┘

  Worker URL:       https://my-project.workers.dev
  Status:           ✓ Reachable (v2.4.0)

  Ensemble Cloud:   ○ Not connected
  Pulse:            ✓ Enabled

Docs: https://docs.ensemble.ai/conductor

ensemble conductor info --compact

🎼 Conductor Info

Project:     my-project v1.2.3 (@ensemble-edge/[email protected])
Environment: development (local)

Components:  47 total (12 agents, 5 ensembles, 30 other)
Triggers:    8 http │ 2 webhook │ 3 mcp │ 1 cron

Cloudflare
  ✓ Workers AI    ✓ KV (2)        ✓ D1           ○ Analytics
  ○ AI Gateway    ○ R2            ✓ DO (2)       ○ Queues
  ✓ Vectorize     ○ Hyperdrive

Worker:      ✓ https://my-project.workers.dev (v2.4.0)
Cloud:       ○ Not connected
Pulse:       ✓ Enabled

ensemble conductor info --json

{
  "project": {
    "name": "my-project",
    "version": "1.2.3",
    "conductorVersion": "2.4.0"
  },
  "config": {
    "conductorConfig": true,
    "wranglerConfig": true
  },
  "environment": "development",
  "components": {
    "agents": { "total": 12, "custom": 10, "builtIn": 2 },
    "ensembles": 5,
    "prompts": 8
  },
  "triggers": {
    "http": 8,
    "webhook": 2,
    "mcp": 3,
    "cron": 1
  },
  "cloudflare": {
    "workersAI": { "configured": true, "bindings": ["AI"] },
    "kv": { "configured": true, "count": 2, "bindings": ["CACHE", "SESSIONS"] }
  },
  "deployment": {
    "workerUrl": "https://my-project.workers.dev",
    "health": { "ok": true, "version": "2.4.0" },
    "cloudEnabled": false,
    "pulse": true
  }
}

ensemble conductor dev

ensemble conductor dev --port 8080

ensemble conductor deploy [environment]

ensemble conductor deploy --env staging

pnpm test [pattern]

pnpm test --coverage

pnpm run build

pnpm run build --env staging --verbose

ensemble conductor run <command> [options]

# Run a CLI command with options
ensemble conductor run generate-docs --output ./docs --format markdown --verbose

# Run with required and optional parameters
ensemble conductor run import-data --file data.json --batch-size 100

# Boolean flags
ensemble conductor run deploy --dry-run --skip-tests

# ensembles/my-cli.yaml
ensemble: my-cli
trigger:
  - type: cli
    command: generate-docs
    description: Generate project documentation
    options:
      - name: output
        type: string
        required: true
        description: Output directory
      - name: format
        type: string
        default: markdown
        description: Output format (markdown, html, pdf)
      - name: verbose
        type: boolean
        default: false
        description: Enable verbose output

flow:
  - agent: docs-generator
    input:
      output: ${trigger.options.output}
      format: ${trigger.options.format}
      verbose: ${trigger.options.verbose}

ensemble conductor ensemble:list --type cli

ensemble conductor validate [path] [options]

# Validate a TypeScript agent
ensemble conductor validate agents/my-agent/index.ts

✗ agents/my-agent/index.ts
  No default export found. TypeScript agents must export a default function:

  export default async function(context: AgentExecutionContext) {
    // your code here
  }

# Validate current directory
ensemble conductor validate

# Validate specific file
ensemble conductor validate ensembles/workflow.yaml
ensemble conductor validate agents/custom-agent/index.ts

# Validate with auto-fix
ensemble conductor validate --fix

# Validate recursively with JSON output
ensemble conductor validate . -r --format json

ensemble conductor bundle <type> <name> [options]

# Bundle an ensemble
ensemble conductor bundle ensemble my-workflow -o my-workflow.tar.gz

# Bundle an agent
ensemble conductor bundle agent company-enricher --format zip

# Preview bundle contents
ensemble conductor bundle ensemble rag-pipeline --dry-run

ensemble conductor import <bundle> [options]

# Import a bundle
ensemble conductor import ./my-workflow.tar.gz

# Preview import
ensemble conductor import ./shared-agent.zip --dry-run

# Force overwrite existing files
ensemble conductor import ./updated-workflow.tar.gz --force

# Skip conflicts
ensemble conductor import ./new-agents.tar.gz --skip

ensemble conductor ensemble:list

ensemble conductor ensemble:run <ensemble> [input]

ensemble conductor ensemble:run greet-user '{"name": "Alice"}'

ensemble conductor agent:list

ensemble conductor agent:run <agent> [input]

ensemble conductor agent:run company-enricher '{"company_name": "Anthropic"}'

ensemble conductor agent:validate <file>

ensemble conductor component:list

ensemble conductor component:create <name> --type <type>

ensemble conductor component:create user-prompt --type prompt

edgit init

edgit info

edgit commit -m "message"

edgit tag create <component> <version>

edgit tag create my-prompt v1.2.0

edgit log [--limit <n>]

edgit diff [commit1] [commit2]

ensemble conductor config:get <key>

ensemble conductor config:get apiKey

ensemble conductor config:set <key> <value>

ensemble conductor config:set apiKey sk-...

ensemble conductor config:list

ensemble conductor keys generate --name <name> [options]

# Full access key
ensemble conductor keys generate --name "admin" --permissions "*"

# Scoped key for billing ensembles
ensemble conductor keys generate \
  --name "billing-service" \
  --permissions "ensemble:billing-*:execute,ensemble:invoice-*:execute" \
  --expires "90d"

# Key that never expires
ensemble conductor keys generate --name "internal" --permissions "*" --expires never

ensemble conductor keys list [options]

ensemble conductor keys revoke <keyId> [options]

ensemble conductor keys info <keyId> [options]

ensemble conductor keys rotate <keyId> [options]

ensemble conductor secret:set <name> [value]

ensemble conductor secret:set OPENAI_API_KEY

ensemble conductor secret:list

ensemble conductor secret:delete <name>

ensemble conductor db:create <name>

ensemble conductor db:migrate [--env <environment>]

ensemble conductor db:query <sql> [--env <environment>]

ensemble conductor db:query "SELECT * FROM users LIMIT 10"

ensemble conductor storage:create <type> <name>

ensemble conductor storage:create kv CACHE

ensemble conductor storage:list <type>

npx wrangler tail [--env <environment>]

npx wrangler tail --filter error

ensemble conductor info

ensemble --version

ensemble upgrade

ensemble conductor --help
ensemble conductor help [command]

ensemble conductor env:list

ensemble conductor env:create <name>

ensemble conductor env:switch <name>

export default {
  name: 'my-project',
  environments: {
    production: {
      accountId: 'abc123...',
      bindings: {
        KV: 'namespace-id',
        DB: 'database-id'
      }
    },
    staging: {
      accountId: 'abc123...',
      bindings: {
        KV: 'staging-namespace-id',
        DB: 'staging-database-id'
      }
    }
  }
};