---
title: "axiom flow pull"
description: "Materialize an existing compiled flow into an editable 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 pull

Materialize an existing compiled flow into an editable flow.yaml

Pull an existing flow artifact's stored SourceGraph and write it back out as
a flow.yaml you can edit and re-compile — the inverse of "axiom flow compile".
The UI edits existing flows; this lets the CLI do the same.

Requires a prior "axiom login". Writes ./flow.yaml (or -o <file>). ADR-086.

## Usage

```sh
axiom flow pull <artifact-id> [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for pull |
| `--out` | `-o` | string | `flow.yaml` | Output flow.yaml path |

## See also

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