User Guides

Welcome to the flow user guides! These guides will help you master flow automation, from basic concepts to advanced workflows.

Getting Started

New to flow? Start here to understand the fundamentals:

• Core Concepts - Learn about workspaces, executables, and vaults
• Your First Workflow - Build a complete automation from scratch

Essential Guides

Master the core features of flow:

• Workspaces - Organize your automation across projects
• Executables - Complete reference for all executable types and configuration
• Working with Secrets - Secure your workflows with encrypted vaults
• Execution History & Logs - View, filter, and manage your execution history

Advanced Topics

Take your automation to the next level:

• Expression Language - Conditionals and dynamic values in flow files
• Advanced Workflows - Complex automation with conditionals, state, and composition
• Imported Executables - Pull in Makefiles, npm scripts, and other existing automation
• Templates & Code Generation - Generate workflows and project scaffolding

Interfaces

• Interactive UI - Customize and use the terminal interface
• Run Provenance - Trace who or what launched every run

Integrations

• AI Tools & MCP - Give a coding assistant your workflows over MCP
• Containers - Run a single step in an image, or the whole CLI in one
• GitHub Actions - Call your executables from a CI pipeline

Other Resources

• CLI Reference - Complete command documentation
• Configuration Reference - YAML file schemas and options
• Examples Gallery - Real-world workflow patterns covering Go projects, Docker, Kubernetes, Git automation, API calls, and more.

Ready to get started? Begin with Core Concepts to understand how flow works, then build your first automation with Your First Workflow!