Build from source

Use this path when you are changing ECP (Execution Control Protocol) packages themselves. Day-to-day usage should install the CLI from npm.

Prerequisites

Node.js 22+
pnpm (install from the repo root, never inside individual packages)

Clone and build

git clone https://github.com/executioncontrolprotocol/executioncontrolprotocol.git
cd executioncontrolprotocol
pnpm install
pnpm run build

Link the CLI:

cd packages/cli
pnpm link --global

From the monorepo root, run an example:

ecp run examples/01-echo/workflow.ts --env examples/01-echo/environment.ts
ecp validate examples/01-echo/workflow.ts --env examples/01-echo/environment.ts

Useful monorepo commands

pnpm run check          # build + schema + lint + tests
pnpm run test:unit
pnpm run generate:schema

Package map and boundaries: see the monorepo AGENTS.md and Packages.

Browser demo with linked packages

For side-by-side work with the Graph Editor, follow the browser-demo repository README (pnpm run dev:linked, pnpm run link:ecp, sibling layout). Public try-out: hosted demo.

Next steps