Pi extension documentation

Deterministic workflows for Pi

pi-extensible-workflows orchestrates resumable work across Pi agents with a small JavaScript DSL, explicit checkpoints, and durable run state.

Read developer docs Read agent docs Author extensions

For developers

Build and integrate

Install the extension, understand its trust boundary, write workflow scripts, register reusable primitives, and operate runs in Pi.

Explore the DSL Author a reusable extension

For agents

Invoke and recover

Choose between workflow and workflow_respond, pass the right script and arguments, and handle checkpoints, retries, and failure.

Start with an invocation

Quick start

Install, then ask Pi to run a workflow

Use Node.js 22.19 or newer and a trusted Pi project. The package registers the workflow tool, the checkpoint response tool, and the /workflow command.

pi install npm:pi-extensible-workflows

Choose a path

Need	Go to
Install, extend, or debug the package	Developer installation
Configure concurrency, model aliases, or workflow-agent resources	Global and project settings
Write a workflow tool call	Agent script contract
Ask for approval before continuing	Checkpoint handling
Inspect a run or recover it	Operations and recovery
Author reusable functions, variables, or setup hooks	Extension authoring
Integrate notifications, dashboards, or audit tools	Lifecycle events

Documentation is versioned with the package

Examples and contracts in this site are maintained beside the implementation. See the repository README for the package overview and bundled agent skill for workflow selection guidance.