Use when the user wants a one-screen view of current hyperflow project state — version, profile freshness, memory count, and live progress on every in-flight task. Read-only; never modifies state, never dispatches workers.
Trigger with /hyperflow:status, "what is hyperflow doing", "show task progress", "where are we".
Use when the user wants a one-screen view of current hyperflow project state — version, profile freshness, memory count, and live progress on every in-flight task. Read-only; never modifies state, never dispatches workers.
Trigger with /hyperflow:status, "what is hyperflow doing", "show task progress", "where are we".
Read-only snapshot of the current hyperflow project, with live progress on every active task file. Standalone — does not auto-chain and is never invoked by other skills. Invoked manually via /hyperflow:status.
In-flight work — per-task live progress (sub-tasks done/total, tokens, wall-clock, ETA)
What to read
Static snapshot
Field
Source
Fallback
Version
Latest git tag matching v* + tag commit date
(missing)
Profile
.hyperflow/profile.md file modification time
(missing)
Memory
Line count of .hyperflow/memory/index.md minus header rows
(none)
Active tasks
Files matching .hyperflow/tasks/*.md
(none)
Active features
Folders matching .hyperflow/features/*/feature.md
(none)
Active features (multi-phase work)
For every .hyperflow/features/*/feature.md (see feature-phases.md), parse its
## Status block and the phase roster, then for each phase-<n>-*/phase.md show the phase status + Progress bar:
The per-phase bar uses the same parsing as the per-task-file section below (each phase.md carries the same
## Status block shape). Omit this section when no .hyperflow/features/*/ exist.
In-flight work (per task file)
For every .hyperflow/tasks/*.md, parse its ## Status block (written by /hyperflow:plan at creation and updated by after each sub-task PASS — see plan/SKILL.md Step 10):
/hyperflow:dispatch
Field
Source
Behaviour
Slug
basename of the task file minus .md
always present
Done / total
Sub-tasks: <done> / <total> from Status block
falls back to counting [x] vs [x]+[ ] checkboxes if Status missing
Done sub-task names
lines with [x] from the ## Batches section
listed under the bar
Running sub-task
the first [~] checkbox (dispatch marks ~ while a sub-task is mid-flight)
grep '^- \[x\]'"$file" | sed -E 's|^- \[x\] *||' | head -5
Show up to the last 3 completed + the currently running sub-task. If there are more than 3 done, prefix the list with … (N earlier done).
Running sub-task
The dispatch skill marks the in-flight sub-task with [~] while the worker is running. After PASS + commit, dispatch flips [~] → [x].
running=$(grep '^- \[~\]'"$file" | sed -E 's|^- \[~\] *||' | head -1)
If no [~] line exists → the dispatch is either between sub-tasks (idle for milliseconds) or has handed control back. Show (idle — last update Xm Ys ago) based on Last update: timestamp.
Progress bar
20-char ASCII bar based on done / total:
[████████████░░░░░░░░] 12/20 60%
Use █ (filled) and ░ (empty). No emoji or color icons.
Output format
Print the block below verbatim. If no in-flight tasks, omit the ── In-flight work ── section.
── Hyperflow Status ─────────────────────────────────────────
Version v3.0.0 (released 2026-05-16)
Profile fresh (analyzed 2h ago)
Memory 12 entries
Active tasks 2
── In-flight work ───────────────────────────────────────────
Task: implement-auth
Progress [███████████░░░░░░░░░] 8/14 57%
Last done T7: Reset email worker
Running T8: Login UI (Implementer · 14s elapsed)
Pending 6 sub-tasks
Tokens thinking 89.2k · worker 142.0k · total 231.2k
Wall-clock 4m 22s elapsed
ETA ~3m 16s remaining (avg 32s/sub-task · 6 left)
Task: fix-login-bug
Progress [░░░░░░░░░░░░░░░░░░░░] 0/3 0%
Status not started (created 8m ago, no dispatch run yet)
─────────────────────────────────────────────────────────────
When Profile is (missing), omit the (analyzed Xh ago) parenthetical.
When Version is (missing), print Version (missing).
When no .hyperflow/tasks/*.md files exist, omit the ── In-flight work ── section entirely; the snapshot block stands alone.
Format as Xm Ys or Hh Mm (skip zero leading units). Show (computing) when done < 3 — too few data points for a useful average.
If the task has multiple batches and the next batch is sequential per the planner output, multiply remaining by 1.1 to account for inter-batch synchronisation overhead.
No .hyperflow/tasks/*.md files → Active tasks (none), no In-flight section
Task file present but Status block malformed/missing → fall back to checkbox count, show (not tracked yet) for tokens/ETA
Started: line absent → Status not started, skip ETA
Never error out. Never modify any file. Never dispatch an agent.
Doctrine
This skill has no Worker/Reviewer dispatch — it is a pure read. It does not count as a hyperflow run and does not append to memory. Output style follows output-style.md — no decorative icons, em-dash separators, plain status words.
Overview
/hyperflow:status prints a one-screen snapshot of the project's hyperflow state plus a live progress block for every in-flight task. Useful when picking up a session mid-flight, deciding whether to invoke /hyperflow:dispatch, or auditing whether a chain run is still healthy. Pure read — no agents, no writes, no chain side-effects.
Prerequisites
Git repository (for the version line — degrades to (missing) otherwise).
.hyperflow/ directory (for profile/memory/tasks lines — each section degrades to (missing) or (none) if absent).
No prerequisites for invocation itself — runs anywhere.
Stat .hyperflow/profile.md for freshness; bucket into fresh/stale/missing.
Count entries in .hyperflow/memory/index.md.
Glob .hyperflow/tasks/*.md and parse each Status block for live progress.
Render the static snapshot block; render the In-flight block per task (if any).
Stop. No prompts, no follow-ups.
Output
See Output format above for the exact block. Two sections — static snapshot and (if there are active tasks) In-flight work with per-task progress bar, last-done sub-task, currently-running sub-task, pending count, tokens, wall-clock, ETA.
Error Handling
Failure
Behavior
Not a git repo
Version (missing); everything else still renders if .hyperflow/ exists.
.hyperflow/profile.md missing
Profile (missing) (no parenthetical).
.hyperflow/memory/index.md missing
Memory (none).
No task files
Omit the In-flight section entirely; just print the snapshot.
Task file with malformed Status block
Fall back to counting [x] vs [ ] checkboxes; show (not tracked yet) for tokens/ETA.
stat flag differs between BSD (macOS) and GNU (Linux)
Try stat -f %m then fall back to stat -c %Y.
Never errors out. Never modifies any file. Never dispatches an agent.
Examples
Healthy project, no active tasks
── Hyperflow Status ─────────────────────────────────────────
Version v3.1.2 (released 2026-05-16)
Profile fresh (analyzed 2h ago)
Memory 12 entries
Active tasks (none)
─────────────────────────────────────────────────────────────
Mid-dispatch with two active tasks
── Hyperflow Status ─────────────────────────────────────────
Version v3.1.2 (released 2026-05-16)
Profile fresh (analyzed 2h ago)
Memory 12 entries
Active tasks 2
── In-flight work ───────────────────────────────────────────
Task: implement-auth
Progress [███████████░░░░░░░░░] 8/14 57%
Last done T7: Reset email worker
Running T8: Login UI (Implementer · 14s elapsed)
Pending 6 sub-tasks
Tokens thinking 89.2k · worker 142.0k · total 231.2k
Wall-clock 4m 22s elapsed
ETA ~3m 16s remaining (avg 32s/sub-task · 6 left)
Task: fix-login-bug
Progress [░░░░░░░░░░░░░░░░░░░░] 0/3 0%
Status not started (created 8m ago, no dispatch run yet)
─────────────────────────────────────────────────────────────
Brand new install (no .hyperflow/ yet)
── Hyperflow Status ─────────────────────────────────────────
Version v3.1.2 (released 2026-05-16)
Profile (missing)
Memory (none)
Active tasks (none)
─────────────────────────────────────────────────────────────
Resources
output-style.md — em-dash style, no decorative chars, plain status words.
DOCTRINE.md — orchestration rules (status is exempt from per-step agent dispatch).
