Unified CLI for the Ensemble ecosystem - AI orchestration for Cloudflare Workers
npm install @ensemble-edge/ensemble> Unified CLI for the Ensemble ecosystem — edge-native AI orchestration built exclusively for Cloudflare
The ensemble CLI provides a single entry point to the entire Ensemble ecosystem: Conductor for AI workflow orchestration, Edgit for component versioning, Chamber for edge data, and Cloud for managed platform connectivity.
Built on Cloudflare's infrastructure: Workers, Workers AI, KV, D1, R2, Durable Objects, Queues, and Vectorize.
``bashLaunch the interactive wizard (no installation needed)
npx @ensemble-edge/ensemble
For CI/CD pipelines, use the
-y flag to skip interactive prompts:`bash
npx @ensemble-edge/conductor init my-project -y
`Commands
$3
| Command | Description |
|---------|-------------|
|
ensemble conductor | AI workflow orchestration for Cloudflare Workers |
| ensemble edgit | Component versioning (prompts, tools, workflows) |
| ensemble chamber | Edge data layer (coming soon) |
| ensemble cloud | Managed platform connection |$3
| Flag | Description |
|------|-------------|
|
-v, --version | Show version |
| -h, --help | Show help |Conductor Commands
Conductor orchestrates AI workflows on Cloudflare Workers.
`bash
Show conductor help
ensemble conductor --helpInitialize a new project
ensemble conductor init [name]Check project status
ensemble conductor status
ensemble conductor status --compact
ensemble conductor status --jsonInitialize with AI provider pre-selected
ensemble conductor init my-project --provider anthropicCI/CD mode (skip interactive prompts)
ensemble conductor init my-project --skip-auth --skip-secretsStart development server (wrangler passthrough)
ensemble conductor devDeploy to production (wrangler passthrough)
ensemble conductor deployValidate project configuration
ensemble conductor validateManage API keys
ensemble conductor keys
`$3
| Flag | Description |
|------|-------------|
|
--json | Output as JSON (for CI/scripting) |
| --compact | Compact single-line format |
| --no-health-check | Skip worker health ping |$3
| Flag | Description |
|------|-------------|
|
--skip-auth | Skip Wrangler authentication check |
| --skip-secrets | Skip AI provider setup |
| --provider | Pre-select AI provider (anthropic, openai, cloudflare) |
| --template | Use a starter template |Edgit Commands
Edgit provides semantic versioning for AI components.
`bash
Show edgit help
ensemble edgit --helpInitialize edgit in current repo
ensemble edgit initCheck edgit status
ensemble edgit status
ensemble edgit status --compact
ensemble edgit status --jsonCreate version tags
ensemble edgit tag create prompt v1.0.0
ensemble edgit tag listManage tracked components
ensemble edgit components list
ensemble edgit components add prompts/greeting.mdSet environment tags and push
ensemble edgit tag set prompt prod v1.0.0
ensemble edgit push --tags --forceView tags and versions
ensemble edgit tag list prompt
`$3
| Flag | Description |
|------|-------------|
|
--json | Output as JSON (for CI/scripting) |
| --compact | Compact single-line format |Cloud Commands
Cloud connects your project to the Ensemble managed platform.
`bash
Show cloud help
ensemble cloud --helpInitialize cloud connection
ensemble cloud init
ensemble cloud init --env stagingCheck connection status
ensemble cloud status
ensemble cloud status --compact
ensemble cloud status --jsonRotate cloud key
ensemble cloud rotateDisable cloud connection
ensemble cloud disable
`$3
| Flag | Description |
|------|-------------|
|
--env | Target environment (default: production) |
| --json | Output as JSON (for CI/scripting) |
| --compact | Compact single-line format |Chamber Commands
Chamber provides an intelligent edge data layer (coming soon).
`bash
Show chamber help
ensemble chamber --helpInitialize Chamber in project
ensemble chamber initCheck cache status
ensemble chamber status
`Wrangler Passthrough
All Wrangler commands work directly through the
ensemble CLI:`bash
ensemble dev # → wrangler dev
ensemble deploy # → wrangler deploy
ensemble tail # → wrangler tail
ensemble secret # → wrangler secret
ensemble kv # → wrangler kv
ensemble d1 # → wrangler d1
ensemble r2 # → wrangler r2
ensemble queues # → wrangler queues
`This means you can use
ensemble as a drop-in replacement for wrangler while gaining access to the full Ensemble ecosystem.Architecture
`
ensemble [args]
│
├── conductor → AI workflow orchestration
│ ├── init, dev, deploy, validate, keys
│ └── (dev/deploy passthrough to wrangler)
│
├── edgit → Component versioning (passthrough to edgit CLI)
│ └── init, tag, components, deploy, history
│
├── chamber → Edge data layer (coming soon)
│
├── cloud → Managed platform
│ └── init, status, rotate, disable
│
├── wrangler → Cloudflare Workers CLI (explicit passthrough)
│
└── * → Wrangler passthrough (dev, deploy, tail, etc.)
``- Ensemble Docs
- Conductor Docs
- Edgit Docs
- Chamber Docs
- Cloud Docs
See CONTRIBUTING.md for development setup and guidelines.
Apache-2.0 - see LICENSE