10 10 - **`/ultra <name> [args]`** — interactive command. Runs a saved workflow behind a
11 - live overlay: a per-agent board, `Tab`/`↑↓` to focus an agent and drill into its
12 - streaming transcript, steer a running sub-agent, and `Esc` to abort.
11 + phase-first live overlay with keyboard phase toggling, agent focus, streaming
12 + transcripts, steering, targeted abort, and confirmed whole-run abort.
13 13 - **`/ultra runs`** — browse, inspect, resume, stop, or delete saved runs.
14 14 - **`/ultra <instructions>`** — injects the authoring prompt, enables the hidden
15 15 `workflow` tool, and starts an agent turn to design or run a workflow.
42 42 ###
Where workflows live 44 44 Discovery merges three locations, lowest-to-highest precedence (a later source
45 -overrides a bundled name):
45 +overrides a bundled name).
46 +Workflow files are rescanned on every completion or invocation, so newly saved JSON works immediately without `/reload`.
47 48 1. **bundled** — `extensions/ultra/workflows/*.json` (ships with ultra)
48 49 2. **global** — `~/.pi/agent/workflows/*.json`
75 76 If a run is aborted, the next matching run on the same session branch reuses completed steps and runs the missing or changed steps.
76 77 A completed run appends a completion marker, so later runs start fresh.
78 -Expanded workflow tool output renders every phase from the start and each known sub-agent as a multiline block.
79 -The tool header shows total workflow wall time while running and freezes it at completion.
79 +Both progress surfaces use the same phase-first hierarchy, authored step summaries, status language, icons, elapsed time, counts, checkpoint state, token usage, and cost.
80 +The overlay also shows each exact resolved sub-agent prompt as the first user message in its transcript.
81 +Collapsed workflow tool output remains counts-only with Pi's standard expand hint.
82 +Expanded tool output summarizes every phase, automatically opens the active and failed phases, shows their agents, and ends with the human-readable workflow outcome.
83 +The command overlay uses the same board, automatically collapses completed phases, and adds keyboard interaction.
84 +Use `↑`/`↓` to focus visible phase or agent rows, `Enter` to toggle a phase, and `Tab` to cycle visible agents.
85 +Use `Alt+↑`/`Alt+↓` to scroll the focused transcript, `s` to steer, and `x` to abort the focused agent.
86 +Aborting the whole run requires two `Esc` presses within 1.5 seconds.
80 87 Known agents appear queued before launch; dynamic fan-outs show `agents not planned yet`; conditional phases show `conditional` until their selectors resolve.
81 -Rows then transition through queued, running, done, dropped, or skipped without disappearing.
82 -Verified Nerd Font icons reinforce each state while text labels preserve meaning without glyph support.
83 -Configured tiers are shown as `tier → provider/model`; collapsed output remains counts-only.
88 +Rows transition through queued, running, done, dropped, or skipped without disappearing from their phase summary.
89 +Configured tiers are shown as `tier → provider/model`.
85 91 Workflow results include aggregate token and cost usage from completed sub-agent turns when the provider reports it.
86 92 The final JSON contains `tokenUsage` with `input`, `output`, `total`, `cacheRead`, `cacheWrite`, and `cost`.