pi-workflows
Workflow engine, JSON control-flow tool, and live terminal viewer for the pi coding agent
File Explorer
- ci.yml
- publish-crate.yml
- publish.yml
- cover.svg
- 2026-08-04-controller-runtime-plan.md
- 2026-08-05-always-on-workflows-plan.md
- 2026-08-10-agent-managed-monitor-workflows-plan.md
- 2026-08-12-coordinated-workflow-timeouts-plan.md
- 2026-08-13-built-in-workflow-catalog-plan.md
- 2026-08-13-responsive-workflow-widget-plan.md
- 2026-08-13-session-addressed-workflow-notifications-plan.md
- 2026-08-16-workflow-updates-plan.md
- 2026-08-17-bundled-skills-plan.md
- 2026-08-19-human-decision-gates-plan.md
- 2026-08-19-human-decision-presentations-plan.md
- 2026-08-19-provider-compatible-workflow-tool-schema-plan.md
- 2026-08-19-workflow-composition-plan.md
- 2026-08-20-autoimplement-blocker-challenge-plan.md
- 2026-08-20-bounded-command-batches-plan.md
- 2026-08-20-herdr-plugin-sync-plan.md
- 2026-08-21-autoimplement-timeout-fallback-plan.md
- 2026-08-21-deferred-turn-intents-plan.md
- 2026-08-21-plan-change-approval-policy-plan.md
- 2026-08-21-sanity-check-plan.md
- 2026-08-22-goal-finishing-monitor-plan.md
- 2026-08-23-assistant-agent-completion-plan.md
- 2026-08-23-sqlite-state-plan.md
- piw-viewer-experience-implementation-plan.md
- replayable-run-bundles-implementation-plan.md
- session-event-replay-implementation-plan.md
- tui-viewer-implementation-plan.md
- 2026-08-18-herdr-piw-plan.md
- 2026-08-20-durable-workflow-launch-plan.md
- CONTROLLERS.md
- DEFERRED_TURNS.md
- DESIGN_PHILOSOPHY.md
- development.md
- HUMAN_DECISION_PRESENTATIONS.md
- HUMAN_DECISIONS.md
- live-replay-protocol.md
- MONITOR.md
- session-event-journal.md
- SQLITE_STATE.md
- tui-viewer.md
- WORKFLOW_COMPOSITION.md
- WORKFLOW_STEP_MESSAGES.md
- WORKFLOW_UPDATES.md
- workflows.md
- pull-request.controller.ts
- approved-plan.workflow.ts
- autoimplement.workflow.ts
- autoplan.workflow.ts
- autoresearch.workflow.ts
- branch.workflow.ts
- command-batch.workflow.ts
- echo.workflow.ts
- human-decision.workflow.ts
- plain-summary.workflow.ts
- sanity-check.workflow.ts
- shell.workflow.ts
- two-turn.workflow.ts
- example-autoimplement.json
- example-autoplan.json
- example-autoresearch.json
- example-branch.json
- example-echo.json
- example-plain-summary.json
- example-shell.json
- example-two-turn.json
- human-multigate.json
- random-1.json
- random-10.json
- random-11.json
- random-12.json
- random-13.json
- random-14.json
- random-15.json
- random-16.json
- random-17.json
- random-18.json
- random-19.json
- random-2.json
- random-20.json
- random-21.json
- random-22.json
- random-23.json
- random-24.json
- random-3.json
- random-4.json
- random-5.json
- random-6.json
- random-7.json
- random-8.json
- random-9.json
- aborted.json
- normal.json
- viewer.mjs
- decision-presentation-v1.schema.json
- human-decision-accepted-v1.schema.json
- human-decision-answer-attempt-v1.schema.json
- human-decision-cancellation-v1.schema.json
- human-decision-continuation-v1.schema.json
- human-decision-delivery-v1.schema.json
- human-decision-receipt-v1.schema.json
- human-decision-request-v1.schema.json
- human-decision-resolution-v1.schema.json
- human-decision-settlement-v1.schema.json
- export-layout-fixtures.mjs
- prepare.mjs
- SKILL.md
- openai.yaml
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- autodoc.workflow.ts
- autoimplement-command-batches.ts
- autoimplement.workflow.ts
- autoplan.workflow.ts
- catalog.ts
- index.ts
- monitor.workflow.ts
- pi-agent-group.ts
- plain-summary.workflow.ts
- plan-approval.workflow.ts
- plan-change.workflow.ts
- plan-presentation.ts
- sanity-check.workflow.ts
- conditions.ts
- definition.ts
- effects.ts
- errors.ts
- index.ts
- json.ts
- loader.ts
- manager.ts
- results.ts
- sqlite.ts
- store.ts
- types.ts
- workflow-engine-scheduler.ts
- workflows.ts
- controller-host.ts
- decision-channels.ts
- deferred-turn-coordinator.ts
- deferred-turn.ts
- executor.ts
- herdr-viewer.ts
- index.ts
- recorder.ts
- session-events.ts
- step-message.ts
- widget.ts
- workflow-tool.ts
- constants.ts
- setup.ts
- processes.ts
- rpc-bridge.ts
- rpc-executor.ts
- runner.ts
- ansi.ts
- canvas.ts
- format.ts
- graph-render.ts
- graph.ts
- node-type.ts
- database.ts
- index.ts
- json.ts
- mutation.ts
- schema.ts
- cli.ts
- render.ts
- session-reducer.ts
- tui.ts
- watch.ts
- catalog.ts
- command-batch.ts
- composition.ts
- decision-presentation.ts
- decision.ts
- definition.ts
- engine.ts
- errors.ts
- graph.ts
- human-decision.ts
- index.ts
- json.ts
- loader.ts
- progress.ts
- schema.ts
- shell.ts
- store.ts
- text.ts
- tool-input.ts
- types.ts
- updates.ts
- herdr-package.e2e.test.ts
- mock-openai.ts
- package-resources.e2e.test.ts
- workflow.e2e.test.ts
- behavior.ts
- child-shutdown-failure.ts
- invalid-openai-provider.ts
- legacy-provider.ts
- native-provider.ts
- read-override.ts
- shutdown-failure.ts
- workflow-capability.ts
- graph-verify.ts
- layout-fixtures.ts
- random-workflows.ts
- assistant-message-types.ts
- autoimplement-command-batches.test.ts
- autoimplement-plan-discovery.test.ts
- builtin-autodoc.test.ts
- builtin-autoimplement.test.ts
- builtin-autoplan.test.ts
- builtin-plain-summary.test.ts
- bundled-skills.test.ts
- catalog.test.ts
- cli.test.ts
- command-batch.test.ts
- composition.test.ts
- controller-core.test.ts
- controller-extension-args.test.ts
- controller-manager.test.ts
- controller-pull-request.test.ts
- controller-services.test.ts
- controller-store.test.ts
- controller-workflow-engine.test.ts
- decision-channel-config.test.ts
- decision-presentation.test.ts
- decision.test.ts
- deferred-turn.test.ts
- engine-more.test.ts
- engine.test.ts
- examples.test.ts
- executor.test.ts
- extension-args.test.ts
- extension.test.ts
- graph-verify.test.ts
- graph.test.ts
- helpers.ts
- herdr-plugin-viewer.test.ts
- herdr-setup.test.ts
- herdr-viewer.test.ts
- host.test.ts
- human-decision-api.test.ts
- human-decision-engine.test.ts
- human-decision-store.test.ts
- json.test.ts
- layout-fixtures.test.ts
- loader.test.ts
- monitor-human-approval.test.ts
- monitor-repair.test.ts
- monitor-workflow.test.ts
- package-resources.test.ts
- park-resume.test.ts
- pi-agent-group.test.ts
- pi-decision-channel.test.ts
- plan-approval.test.ts
- plan-change.test.ts
- recorder.test.ts
- render.test.ts
- review-fixes.test.ts
- rpc-executor-flow.test.ts
- rpc-executor.test.ts
- run-continuation.test.ts
- run-fencing.test.ts
- run-queue.test.ts
- run-resume.test.ts
- sanity-check-workflow.test.ts
- schema.test.ts
- session-events.test.ts
- session-reducer.test.ts
- shell.test.ts
- sqlite-lifecycle.test.ts
- sqlite-run-store-branches.test.ts
- state-concurrency.test.ts
- state-database.test.ts
- step-message.test.ts
- store.test.ts
- telegram-decision-channel.test.ts
- updates.test.ts
- watch.test.ts
- widget.test.ts
- workflow-args.test.ts
- workflow-tool-input.test.ts
- workflow-tool-provider.test.ts
- mod.rs
- reader.rs
- types.rs
- mod.rs
- controls.rs
- conversation.rs
- graph.rs
- mod.rs
- theme_picker.rs
- timeline.rs
- canvas.rs
- client.rs
- format.rs
- layout.rs
- lib.rs
- main.rs
- protocol.rs
- render.rs
- server.rs
- session.rs
- source.rs
- sqlite.rs
- .gitignore
- Cargo.lock
- Cargo.toml
- README.md
- .gitignore
- .oxfmtrc.jsonc
- AGENTS.md
- herdr-plugin.toml
- LICENSE
- package-lock.json
- package.json
- README.md
- slophammer.yml
- tsconfig.build.json
- tsconfig.json
- vitest.config.ts
- vitest.e2e.config.ts
# Use via CDN
jsDelivrjsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.
Command Glossary
Commands referenced in this DOCs, explained below.
cargo install
View Details ▼
cargo install
Build and install a Rust binary.
cargo install {{package}}@{{version}}
Install a package from <https://crates.io> (the version is optional - latest by default):
cargo install --git {{repo_url}}
Install a package from the specified Git repository:
cargo install --git {{repo_url}} --{{branch|tag|rev}} {{branch_name|tag|commit_hash}}
Build from the specified branch/tag/commit when installing from a Git repository:
npm install
View Details ▼
npm install
Install Node packages.
npm {{[i|install]}}
Install dependencies listed in `package.json`:
npm {{[i|install]}} {{package_name}}@{{version}}
Download a specific version of a package and add it to the list of dependencies in `package.json`:
npm {{[i|install]}} {{package_name}} {{[-D|--save-dev]}}
Download the latest version of a package and add it to the list of dev dependencies in `package.json`:
npx
View Details ▼
npx
This command is an alias of `npm exec`.
tldr npm exec
View documentation for the original command:
shift
View Details ▼
shift
Move positional parameters.
shift
Remove the first positional parameter:
shift {{n}}
Remove the first `n` positional parameters:
task
View Details ▼
task
To-do list manager.
task add {{description}} due:{{tomorrow}}
Add a new task which is due tomorrow:
task {{task_id}} modify priority:{{H|M|L}}
Update a task's priority:
task {{task_id}} done
Complete a task:
