Pi workflow documentation

Deterministic workflows and focused agents for Pi

Coordinate resumable multi-agent jobs with the core workflow extension, launch independent single-shot agents with Subagents, and move workflow sessions into Herdr when you need live inspection.

Build a workflow Run a subagent Use Herdr

Core workflows

Orchestrate durable jobs

Compose agents, shell gates, approvals, worktrees, budgets, registered functions, and recovery in one deterministic script.

Explore the workflow DSL

Single-shot agents

Launch focused work

Start one independent agent per task, return immediately or wait, then inspect, steer, stop, or retry by durable ID.

See the five tools

Herdr integration

Open agent sessions in panes

Hand off a live workflow agent, inspect a completed session, or run every workflow agent in a Herdr workspace.

See the available actions

Trusted extensions

Install, then ask Pi to run a workflow

Use Node.js 22.19 or newer and a trusted Pi project. The core package registers workflow launch, status, checkpoint, stop, retry, and resume tools, the conditional catalog tool, the background widget, and the /workflow command.

pi install npm:pi-extensible-workflows

Choose a path

Need	Go to
Install, configure, write, or operate workflows	Developer guide
Launch one independent agent without a workflow script	Subagents guide
Move workflow-agent sessions into Herdr panes	Herdr guide
Define or override reusable agent policy	Roles guide
Use or build trusted workflow extensions	Extensions guide
Inspect, run, export, or bundle from a terminal	CLI operations
Give an LLM exact configuration and authoring contracts	LLM guide

Start with the main README

The repository README is the canonical product overview and package map. This site contains the navigable full documentation. The bundled workflow skill is the canonical agent-facing guide for workflow selection, authoring, and recovery.