About this template
Stop leaving Pi to get control flow
You already have the long conversation going.
What you want next is a branch: propose → holy grail → y/n → implement. Not an export to n8n. Not a CI runner. Not a second harness holding half your context.
This fork boots Pi with osolmaz/pi-workflows already installed and the example graphs seeded. Type /workflow and the boxed widget is there.
The demo that proves it
export ANTHROPIC_API_KEY=... # or OPENAI_API_KEY / GEMINI_API_KEY
pi
/workflow
/workflow echo summarize this repository
Or talk through a real problem first, then run:
/workflow elegant-solution
The graph advances above the editor: propose → holy grail → decision → implement, or a human checkpoint when it needs you. Same conversation. Same terminal.
What lands in your fork
- The pi-workflows extension —
pi install git:github.com/osolmaz/pi-workflowsalready run, package under~/.pi/agent/git/…, registered insettings.json - Seven seeded graphs, each callable as
/workflow <name>:echo— the smallest end-to-end graphelegant-solution— Socratic propose → holy grail → y/n → implementautoimplement— implement → verify → review loopbranch,two-turn,shell,autoresearch
- Runtime deps already in persist (
jiti,typebox), so imports resolve on the build VM instead of dying on the first run - A native in-Pi widget — the graph lives where you are typing, not in a separate web viewer
What you must supply (BYOK)
One model key, exported in your own shell:
export ANTHROPIC_API_KEY=...
# or OPENAI_API_KEY / GEMINI_API_KEY
pi
Keys are never part of the template. Run /workflow list to see every seeded graph.
Your first five minutes
Fork it, export a key, run /workflow echo summarize this repository. That proves the wiring end to end in about a minute.
Then bring a real decision and run /workflow elegant-solution. Read the graph. Answer y or n. That is the whole product.
Honest limits of in-harness workflow control flow
This is Pi, and only Pi. Claude Code, Codex and OpenClaw users want a different fork.
It is control flow inside the harness — not a CI orchestrator, not a scheduler, not a job queue. Writing a graph of your own means writing TypeScript. And BYOK means what it says: you hold the model keys, and the model spend is yours.
Provenance
Built on osolmaz/pi-workflows by Onur Solmaz. Pi: pi.dev.
Fork it. Own the box. Keep the conversation. Your first purchase carries a 30-day money-back guarantee.