Organization and References

Workspaces, namespaces, and the URI-like reference system. How flow finds the right workspace, and why registration is an optimization rather than a requirement.

The Execution Engine

The five executable types, how parameters and arguments reach a process, running a step inside a container, and where state lives between steps.

Secrets and the Vault

Five vault backends, how secrets reach a process without touching the command line, and why external vaults store links rather than copies.

flow as an Agent Runtime

The MCP server, why running work through flow beats a raw shell tool, and the Python interpreter that is currently in flight.

Generation and Integrations

Templates for scaffolding new projects, importing executables from files you already have, and where flow plugs into CI and other tools.