Skip to main content
Get an ECP Context running locally in three steps.

​
Prerequisites

  • Node.js 22+ (required for schema generation and full builds in this repo; see Development)
  • npm (v7+ for workspaces) or pnpm
  • For OpenAI: set OPENAI_API_KEY. For Ollama: install Ollama and run it locally.

​
Step 1: Clone and install

​
Step 2: Run a Context

Install the CLI from the repository (one-time). This gives you the ecp command:
Then run the single-executor example with OpenAI:
Or validate a Context without running it:
After ecp run, tracing is enabled by default. You can inspect the latest run with:
Disable tracing with --no-trace (traces default to ~/.ecp/traces). For every flag and option on your installed CLI, run ecp --help or ecp run --help (same pattern for validate and trace). For Ollama (no API key):

​
Step 3: Inspect the manifest

The canonical example Context is spec.yaml at the repo root. It includes:
  • inputs — parameters like shopifyStoreId, jiraProject
  • outputs — structured results (e.g. from a schema)
  • schemas — JSON Schema-like definitions for outputs
  • triggers — when the Context runs (e.g. schedule, webhook)
  • orchestration — entrypoint, strategy, delegation defaults
  • executors — agents with models, mounts, and policies

​
Next steps

  • Development — preview docs locally, global CLI install
  • Concepts — Context, executors, mounts, orchestration
  • SETUP.md — env vars, system config, Ollama details