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+
npm (install from the repo root, never inside individual packages)

Clone and build

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

Link the CLI:

cd packages/cli
npm link

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

npm run check          # build + schema + lint + tests
npm run test:unit
npm 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 browser demo, clone the demo as a sibling, rebuild monorepo dist/, then follow the demo README’s npm link procedure so the Graph Editor picks up local @executioncontrolprotocol/* builds.

Next steps