Install Stageflow
Use the install script on macOS or Linux. Node.js 20 or newer is required.
$ curl -fsSL https://raw.githubusercontent.com/tejasghutukade/stageflow/main/install.sh | bash
A workflow you can see thinking
Complex work.
Clear motion.
Scroll through one live run. Every decision, handoff, and verification becomes part of the product story.
Scroll to start ↓01 / One focused job
Agents get a stage.
Not a universe.
The researcher gathers evidence. The analyst finds the signal. The writer shapes the brief. Smaller contexts create work you can inspect.
02 / Typed handoffs
Meaning survives
the handoff.
Every stage passes a schema-checked artifact forward—not an ambiguous transcript that the next agent has to reinterpret.
# output contract
produces: evidence.v1
requires:
- source_url
- claim
- confidence
produces: evidence.v1
requires:
- source_url
- claim
- confidence
03 / Verification
Prove it before
it moves.
Structure, citations, policy, tests, or your own acceptance rules decide whether the workflow advances, retries, or asks for help.
04 / Dynamic routing
The route adapts.
The bounds do not.
Verified outputs choose the next stage. Every possible branch is still declared, visible, and safe to reason about.
05 / Human checkpoint
Judgment enters
at the right moment.
The run pauses with its state intact. You review the decision—not the entire history—then approve, revise, or choose another route.
06 / Simple YAML
Extraordinary runs.
Ordinary files.
The whole route stays readable, reviewable, and versioned beside your code. No proprietary canvas required.
id: product-intelligence
stages:
- uses: ./research.yaml
entry: true
route: [{ to: verify }]
- uses: ./verify.yaml
route: [{ to: publish }]
- uses: ./publish.yaml
Build your first flow →stages:
- uses: ./research.yaml
entry: true
route: [{ to: verify }]
- uses: ./verify.yaml
route: [{ to: publish }]
- uses: ./publish.yaml