Guides
Practical guides for using taskflow on different hosts and patterns.
The Guides are the practical half of these docs. Where Concepts explains the model and the Syntax Reference lists every field, the Guides walk you through doing something real end to end — install on a specific host, run a flow, save it, debug it, and reach for an advanced pattern when the work demands it.
They come in two flavors:
- By host. taskflow runs on Pi, Codex, Claude Code, and OpenCode. Each host has its own install path and invocation surface, so each gets a dedicated walkthrough.
- By pattern. Once the basics work, some problems want a specific shape — a model that plans its own sub-flow at runtime, or a tournament that spawns competing drafts and picks a winner.
New to taskflow? Start with the host you already use. Both host guides end with the same runnable review flow, so you can compare notes across hosts afterwards.
By host
Using taskflow on Pi
Install the extension, run with /tf, save flows, and configure model roles.
Using taskflow on Codex
Install the plugin, call taskflow_run over MCP, and handle long-running flows.
By pattern
Dynamic Planning
Generate sub-flows at runtime and validate them before execution.
Tournament Selection
Spawn competing variants and let a judge pick the best.
Case studies
End-to-end walkthroughs of real tasks, showing how multiple phase types work together.
Code Audit
Review changed files for security and architecture risks, then gate on high-severity findings.
Release Note Headlines
Use a tournament to pick the strongest release-note headline from competing variants.
Migration Planner
Plan a codebase migration dynamically, validate the plan, execute it, and loop until done.
Submit your own
Have a taskflow that saved you hours? Share it with the community.
Last updated on
Was this helpful?
Help us improve the docs or ask a question in the community.