| name | background |
| description | Use when the user wants to see, inspect, cancel, or prune background agents fired during prior chain runs. Read/manage `.hyperflow/background/registry.json` and the per-agent output buffers at `.hyperflow/background/<id>.md`. Standalone — never auto-invoked.
Trigger with /hyperflow:background, "list background agents", "what's running in background", "cancel background agent", "show background result".
|
| allowed-tools | Read, Write, Edit, Bash(ls:*), Bash(cat:*), Bash(rm:*), Bash(find:*), Glob, Grep |
| argument-hint | <list|show|cancel|prune> [id|--all] |
| version | 4.7.0 |
| license | MIT |
| compatibility | Designed for Claude Code |
| tags | ["background","orchestration","lifecycle"] |
Background
Read-only-by-default management interface for background agents fired by other hyperflow skills (dispatch quality gates, deploy CI watcher, scaffold analysis refresh, cache compact, scope speculative prefetch). Reads from .hyperflow/background/registry.json + per-agent output buffers.
Full doctrine: background-agents.md.
Subcommands
| Subcommand | Description |
|---|
list | Print the registry: in-flight · completed-uncollected · stalled · errored |
show <id> | Print one agent's output buffer (.hyperflow/background/<id>.md) |
cancel <id> | Cancel one specific in-flight agent |
cancel --all | Cancel every in-flight agent (use before closing a session) |
prune | Delete completed .hyperflow/background/<id>.md files older than 7 days |
Default subcommand when none provided: list.
Subcommand Details
list
Read .hyperflow/background/registry.json. Group entries by status and print a compact table:
## In flight (N)
| ID | Purpose | Fired | Timeout | Blocks |
|-----------------------------------|--------------------------------------|------------|---------|---------|
| `bg-1718049600-quality-gates-b2` | Layer 5 gates Batch 2 | 17:30 | 18:00 | step3 |
| `bg-1718049820-ci-watcher` | GitHub Actions watch for v4.7.0 | 17:33 | 18:33 | — |
## Completed (uncollected, N)
| ID | Purpose | Completed | Duration | Output |
|-----------------------------------|--------------------------------------|------------|----------|--------|
| `bg-1718045400-scaffold-refresh` | Refresh .hyperflow/architecture.md | 16:42 | 2m 18s | 1.4kb |
## Stalled / Errored (N)
| ID | Purpose | Status | Reason |
|-----------------------------------|--------------------------------------|-------------------|-------------------|
| | Compact learnings.md | STALLED | timeout (30m) |
