User Guides
From the core ideas to advanced workflows and integrations.
Getting Started
- What is flow?: what flow does and why
- Coming From…: bringing Make, npm, just, Task or scripts into flow
Using flow
- Concepts: workspaces, executables and vaults
- Your First Workflow: build a complete workflow from scratch
- Executables: every executable type and option
- Workspaces: organize tasks across projects
- Secrets: encrypted vaults for keys and tokens
- History & Logs: view, filter and manage past runs
- Interactive UI: the terminal interface
Going Further
- Expression Language: conditionals and dynamic values in flow files
- Advanced Workflows: conditionals, state and composition
- Imported Executables: comment syntax for imported scripts and Makefiles
- Templates & Workflow Generation: generate workflows and project scaffolding
AI & Integrations
- AI Tools & MCP: give a coding agent your workflows over MCP
- Run Provenance: trace who or what started every run
- Containers: run a single step in an image, or the whole CLI in one
- GitHub Actions: call your executables from CI
Reference
- CLI Reference: every command and flag
- Configuration Reference: flow file, workspace and config schemas
- Examples: flow files for Go, Docker, Kubernetes, Git and HTTP APIs

