---
url: https://docs.mochiexec.io/reference/flow.md
description: >-
  Where to find flow's reference documentation, including flow file, workspace,
  and config schemas, the CLI, and JSON schemas. All of it applies to Mochi
  unchanged.
---

# flow Reference

Mochi runs on flow, so flow's configuration formats are Mochi's. These are documented on
[flowexec.io](https://flowexec.io) and apply unchanged.

## Configuration

| Reference | Covers |
|---|---|
| [Flow file](https://flowexec.io/types/flowfile) | Executables: verbs, types, arguments, parameters |
| [Workspace](https://flowexec.io/types/workspace) | `flow.yaml`: a workspace's settings, imports, and environment |
| [Config](https://flowexec.io/types/config) | Global user configuration |
| [Template](https://flowexec.io/types/template) | Workflow and project templates |

## JSON schemas

Point your editor at these to get validation and completion in flow files:

* `https://flowexec.io/schemas/flowfile_schema.json`
* `https://flowexec.io/schemas/workspace_schema.json`
* `https://flowexec.io/schemas/config_schema.json`
* `https://flowexec.io/schemas/template_schema.json`

## Guides

| Guide | Covers |
|---|---|
| [Concepts](https://flowexec.io/guides/concepts) | Workspaces, executables, and vaults, and how they fit together |
| [Executables](https://flowexec.io/guides/executables) | Writing executables |
| [Secrets](https://flowexec.io/guides/secrets) | Vaults and secrets |
| [Templates](https://flowexec.io/guides/templating) | Generating workflows |
| [Expressions](https://flowexec.io/guides/expressions) | The expression language |
| [AI tools & MCP](https://flowexec.io/guides/ai-tools) | The MCP server behind `mochi mcp` |

## CLI

[flow CLI reference](https://flowexec.io/cli/): every flow command, which you can also run
as `mochi`.