---
title: "axiom flow"
description: "Author and compile flows (graphs of published nodes)"
category: reference
surfaces: [cli]
related: [reference/cli/axiom, reference/cli/axiom-flow-compile, reference/cli/axiom-flow-layout, reference/cli/axiom-flow-new, reference/cli/axiom-flow-publish, reference/cli/axiom-flow-pull, reference/cli/axiom-flow-run, reference/cli/axiom-flow-validate]
last_reviewed: 2026-06-06
---

<!-- GENERATED by docs/scripts/gen-cli-reference — DO NOT EDIT.
     Source of truth: the cobra command definitions in cmd/axiom/cmd/.
     Regenerate from the repo root with: go run ./docs/scripts/gen-cli-reference -->

# axiom flow

Author and compile flows (graphs of published nodes)

Author and compile Axiom flows from a flow.yaml.

A flow.yaml composes published nodes (referenced by package + node name) into a
graph. The usual loop:

```text
axiom flow new my-flow                  # scaffold my-flow.flow.yaml
# edit it: add nodes + wire edges
axiom flow validate my-flow.flow.yaml   # structural checks
axiom flow layout   my-flow.flow.yaml   # auto-position on the canvas grid
axiom flow compile  my-flow.flow.yaml   # resolve nodes + compile a runnable flow
```

Node positions are coarse grid cells (col, row); omit them to auto-layout.

## Usage

```sh
axiom flow [flags]
axiom flow [command]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for flow |

## Subcommands

| Command | Description |
|---|---|
| [axiom flow compile](./axiom-flow-compile.md) | Resolve nodes, lay out, and compile a runnable flow artifact |
| [axiom flow layout](./axiom-flow-layout.md) | Auto-position nodes on the grid and write col/row back |
| [axiom flow new](./axiom-flow-new.md) | Scaffold a starter flow.yaml |
| [axiom flow publish](./axiom-flow-publish.md) | Publish a compiled flow to the public marketplace |
| [axiom flow pull](./axiom-flow-pull.md) | Materialize an existing compiled flow into an editable flow.yaml |
| [axiom flow run](./axiom-flow-run.md) | Invoke a compiled flow and print its result |
| [axiom flow validate](./axiom-flow-validate.md) | Validate a flow.yaml's structure (local checks) |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages
- [axiom flow compile](./axiom-flow-compile.md) — Resolve nodes, lay out, and compile a runnable flow artifact
- [axiom flow layout](./axiom-flow-layout.md) — Auto-position nodes on the grid and write col/row back
- [axiom flow new](./axiom-flow-new.md) — Scaffold a starter flow.yaml
- [axiom flow publish](./axiom-flow-publish.md) — Publish a compiled flow to the public marketplace
- [axiom flow pull](./axiom-flow-pull.md) — Materialize an existing compiled flow into an editable flow.yaml
- [axiom flow run](./axiom-flow-run.md) — Invoke a compiled flow and print its result
- [axiom flow validate](./axiom-flow-validate.md) — Validate a flow.yaml's structure (local checks)