Most day-to-day CLI work happens through flows. Pin an active Flow with nora flows use <slug> and the rest of the commands default to it.
List
Shows every Flow in the active workspace with its slug, name, and last-published version.
Get one
Prints the full Flow payload (Blocks, wiring, settings, publish state) as JSON.
Snapshot for editing
Dumps just the editable payload. Ideal for git-tracking your Flows or bulk edits with jq.
Apply from a file
Upserts the Flow from a JSON file. If <slug> doesn’t exist, it’s created. Use --name "..." on first apply to set the display name.
Delete
Deletes the Flow. This is irreversible — but published versions remain reachable via their version IDs for a grace period.
Publish
Snapshots the current Draft as a new version and moves the published pointer. Only Owners and Managers can publish.
Rollback
Moves the published pointer back to an earlier version. Your Draft is not touched.
Restore (Draft only)
Copies an old version’s payload into the Draft. Production is untouched. Use this when you want to edit off an old version instead of shipping it as-is.
Settings
Settings apply to every run of the Flow — good place to cap costs across all Agents at once.
Pin the active Flow
Pinned per-workspace, so switching workspaces switches Flows too.
Version history
Every publish, rollback, and restore is recorded — you can walk the whole history.
Empty canvases and re-publishing an identical Flow are rejected server-side. This is the same guardrail as the Publish button in the app.
