---
title: "axiom flow layout"
description: "Auto-position nodes on the grid and write col/row back"
category: reference
surfaces: [cli]
related: [reference/cli/axiom-flow]
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 layout

Auto-position nodes on the grid and write col/row back

Run the coarse-grid layout engine over the flow's topology and write the
resulting (col, row) cell onto every node, so you can see and tweak the
placement. Pinned nodes keep their cell. Defaults to ./flow.yaml.

## Usage

```sh
axiom flow layout [flow.yaml] [flags]
```

## Flags

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

## See also

- [axiom flow](./axiom-flow.md) — Author and compile flows (graphs of published nodes)