Skip to main content

Quickstart

Get ECP (Execution Control Protocol) running in a few minutes: install the CLI, add the agent skill, and run a workflow file.

Prerequisites

  • Node.js 22+
  • npm

Install

The field-test is 0.50.0 on latest (not 1.0). Contributors who are changing packages can build from source. Confirm the binary:

Author and run

Scaffold a workflow, or copy the echo example from the monorepo:
--env is optional. Omit it to use the process host (built-in Node plus installed plugins):
--json prints { ok: true, data } or { ok: false, error: { code, message, path, suggestions } }. Journals land under .ecp/runs/<runId>/. Install a plugin when a workflow needs one:
Third-party plugins ask for approval. First-party npm packages install without a prompt.

Next steps