Saphan StudioDocs
Reference/Commands

saphan wave

Shows the fleet's streams from the branch, gate and merge point of view.

Shows the fleet's streams from the branch, gate and merge point of view.

saphan wave

saphan wave show

Lists every stream with its current state, its branch and base, its latest gate decision and whether a real merge commit was seen, ending with the one notice that needs attention. ⚠ It exits 2 when a human gate decision is pending, so a script can act on the exit code. With --json it gives a summary per stream plus the admitted machines, and total_count always reports the fleet's full size even when filters narrow the rows.

saphan wave show
flagtypedefaultwhat it does
--changed-sincestringShow only streams that changed at or after the as_of_ts value of an earlier --json response, for polling.
--detailstringsummary (the default) or full, which adds evidence, phase timings and merge messages to --json output.
--sincestringShow only streams updated at or after this RFC 3339 time.
--statestringShow only streams whose state reads exactly this, for example in-flight or gated:accept.
--streamsstringSliceShow only these streams (comma-separated, or repeat the flag).

Global options apply to every command — see Every command.

On this page