Skip to content

agnify pipeline

Print the current draft execution as JSON.

Reads AGNIFY_DRAFT_EXECUTION_ID from env (the subprocess wrapper sets this when the session is bound to a draft).

Usage

Terminal window
agnify pipeline get

Print the current draft execution as JSON. Alias for get.

Usage

Terminal window
agnify pipeline pull

Replace the draft’s whole node snapshot with SNAPSHOT. Alias for set.

Usage

Terminal window
agnify pipeline push SNAPSHOT

Arguments

NameDescription
SNAPSHOTA snapshot as inline JSON (starts with ’{’ or ’[’) or the path to a JSON file. Either a bare list of nodes or an object with a ‘nodes’ field is accepted.

PUT /executions/{draft}/config with the snapshot.

The snapshot replaces the draft’s node list wholesale, so it must carry every node you want the run to keep, not just the ones you changed. agnify pipeline pull prints the whole execution, so extract its pipeline_snapshot field (jq .pipeline_snapshot) and edit that — piping pull straight back in is rejected as the wrong shape.

The local validator runs first and short-circuits on any issues — the backend would catch most of these at the Pydantic boundary, but the local check keeps the round-trip cost on the caller’s side and produces a list of problems instead of the first one.

Usage

Terminal window
agnify pipeline set SNAPSHOT

Arguments

NameDescription
SNAPSHOTA snapshot as inline JSON (starts with ’{’ or ’[’) or the path to a JSON file. Either a bare list of nodes or an object with a ‘nodes’ field is accepted.

Validate a snapshot locally — no HTTP, no DB.

On success, prints {"ok": true, "node_count": N}. On failure, prints {"ok": false, "issues": [...]} to stderr and exits non-zero so a caller can iterate without a round-trip.

Usage

Terminal window
agnify pipeline validate SNAPSHOT

Arguments

NameDescription
SNAPSHOTA snapshot as inline JSON (starts with ’{’ or ’[’) or the path to a JSON file. Either a bare list of nodes or an object with a ‘nodes’ field is accepted.