@firstpick/pi-extension-workflows

Minimal modular workflow runtime extension for Pi.

Packages

Package details

extension

Install @firstpick/pi-extension-workflows from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@firstpick/pi-extension-workflows
Package
@firstpick/pi-extension-workflows
Version
0.1.9
Published
Aug 7, 2026
Downloads
2,658/mo · 398/wk
Author
firstpick
License
MIT
Types
extension
Size
360.7 KB
Dependencies
3 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Workflows for Pi

Run saved, repeatable Pi workflows without putting all workflow logic in one large prompt.

What you can do

  • Runs reusable workflows stored as files.
  • Shows progress, pauses, resumes, and retries.
  • Supports safe worktree-based changes when a workflow needs them.
  • Lets successful runs be saved as reusable workflows.

Install

Install it through Pi:

pi install npm:@firstpick/pi-extension-workflows

Restart Pi if the package does not appear in your current session.

How to use it

List the workflows available to you:

/workflow list

Run one by name:

/workflow run my-workflow

Control a run with:

  • /workflow status <run-id> — check progress.
  • /workflow pause <run-id> — pause it.
  • /workflow resume <run-id> — continue it.
  • /workflow abort <run-id> — stop it.
  • /workflow-setup — review workflow settings.

Saving runs, retrying individual steps, importing workflows, and worktree handling are described in the technical reference.

Technical details

See TECHNICAL.md for complete commands, configuration, compatibility, security, and troubleshooting information.