---
title: "axiom flow new"
description: "Scaffold a starter flow.yaml"
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 new

Scaffold a starter flow.yaml

Scaffold a starter <name>.flow.yaml with two example nodes and an edge.

Edit it to set each node's package + node name (find them with
"axiom search --json") and wire the edges, then validate/layout/compile.

## Usage

```sh
axiom flow new <name> [flags]
```

## Flags

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

## See also

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