crewplane 0.1.0a1

A CLI orchestrator for AI agents

Crewplane / Orchestrator CLI

Crewplane runs AI coding CLIs through auditable Markdown workflows.

Define a DAG in a .task.md file, assign nodes to providers such as Claude, Codex, Gemini, Copilot, Kilo, or any generic CLI, and let orchestrator run the graph while preserving inputs, intermediate outputs, logs, manifests, and final results under .orchestrator/.

Crewplane is built around three ideas:

• Workflows are Markdown files with explicit dependencies.
• Providers are external CLIs, not vendor SDK integrations.
• Execution state is written to disk as readable artifacts.

Install

Recommended isolated install:

uv tool install crewplane

The public package name is crewplane. The installed command is orchestrator.

Provider CLIs are installed and authenticated separately. Crewplane does not install provider CLIs, does not manage provider credentials, and does not sandbox provider CLI execution.

First Run

orchestrator init
orchestrator validate
orchestrator run --dry-run
orchestrator run

orchestrator init creates .orchestrator/config.yml, a default workflow, and additional example templates under .orchestrator/workflows/example-templates/.

Workflow Shape

---
schema_version: "<current>"
name: "Quick Review"
nodes:
  - id: review.context
    mode: parallel
    providers: ["claude", "codex"]
---

## review.context
Review the current repository and report the highest-risk issues.

Full workflow authoring docs are in the workflow syntax reference.

Safety Boundary

Crewplane coordinates provider CLIs; it is not a security sandbox. Provider CLIs run with the permissions, approval mode, network access, and filesystem access configured for those tools.

{{file:path}} template references are bounded to the project root by default. External files must be explicitly allowlisted with settings.integrations.artifacts.options.allowed_template_paths.

Where Next

• Documentation index
• Installation
• Quickstart
• Provider setup
• Examples
• Command reference
• Configuration reference
• Workflow syntax reference
• Artifact reference
• Security and trust
• Architecture
• Contributing and local development