Skip to content

flow · open sourceWrite your workflows down.

Then run them from any project on your machine — with the right secrets, the right environment, and a record of what happened.

flow
  • Install
  • Latestv2.2.1
  • Runs onmacOS · Linux · Windows

01Write

Workflows are YAML you keep next to the code they run.

A flow file declares what a task does, what it needs, and how it runs: in order, in parallel, behind a condition, as an HTTP request, or as a background job. Check it in and the automation travels with the repo.

Not another YAML dialect — every flow file validates against a published JSON schema, so your editor autocompletes it before flow ever sees it.

02Run

One binary, every project on your machine.

Register a repo as a workspace and its workflows are reachable from anywhere — by name from your shell, or by browsing them in the terminal UI. Secrets come out of an encrypted local vault at the moment they are needed, never out of a file you committed.

Not a task runner you have to cd into — flow knows where every workspace lives, so the command reads the same from any directory.

03Connect

The same workflows, from your terminal or your coding agent.

flow mcp exposes every executable over the Model Context Protocol, so an assistant can discover what a project is able to do, run it, and read the logs back — through the same engine you use by hand.

Not an AI product — flow ships the tools and stops there. No vendor keys and no model calls in the critical path of a task runner.

All guides

Workspaces

Register any repo once. Its executables are then addressable from anywhere, with that project's environment applied.

registry·git·discovery

Executables

Six execution types, conditionals, retries, arguments, and prompts — composed from other executables by reference.

serial·parallel·request·render·launch

Vaults

Encrypted local secret storage with pluggable backends. Values are injected into the process at run time and never written to disk.

AES-256·age·keyring·env

Templates

Bootstrap new projects and new workflows from templates you author, with prompts and generated files.

scaffolding·generation

Interactive UI

Browse, filter, and run every workflow across every workspace from one terminal interface — then watch the logs stream.

browse·search·logs

AI tools

MCP

A deterministic tool surface for assistants: discover, run, and author workflows, with full provenance on every run.

Claude Code·Cursor·any MCP client

Examples gallery

  • Install flow — one line on macOS, Linux, or Windows
  • Quickstart — a working workflow in about five minutes
  • Core concepts — workspaces, executables, and vaults, and how they fit together
  • Examples — real flow files for Go, Docker, Kubernetes, Git, and HTTP APIs
  • flow's own automation — this project builds, tests, and releases itself with flow
  • How flow is built — an architecture deep dive from Dockery Labs, the workshop behind flow

Mochi: your workflows, neatly wrapped

Want a desktop dashboard, workflow auto-discovery, and AI enrichment on top of flow? Sign up for early access →

A short path to everything you run.