hopper-progresslisted
Install: claude install-skill litianyi-007/hopper-plugin
# Hopper Progress
Use progress commands for background-dispatched Hopper tasks. These commands read file-backed state from `.hopper/handoffs/`.
## Steps
1. Locate the target project root containing `.hopper/`, then locate `hopper-dispatch` from `PATH` or the plugin root near this `SKILL.md`.
2. For task-specific commands, validate the task ID with `^[A-Za-z][A-Za-z0-9._-]{0,99}$`.
3. For a snapshot, run `hopper-dispatch --progress <task-id>`.
4. To follow one task until terminal state, run `hopper-dispatch --watch <task-id>` only when the user wants a blocking watch.
5. To stream terminal events across tasks, run `hopper-dispatch --watch-events`; add `--once` only for scripts or when the user asks for one event.
6. Report status, phase, elapsed time, last progress text, output paths, and terminal event details.
When a terminal event carries `recovered_output: true`, report its closed `recovered_output_state` and `recovered_output_source`, while keeping the terminal status unchanged. For a failed task, retrieve only parser-designated text and the state-specific action guidance with `hopper-dispatch --result <task-id> --full`; do not use raw logs as a result source.
## Safety
- Do not poll faster than needed; for waiting users, about every 10 seconds is enough.
- Do not re-dispatch failed or orphaned tasks from this skill.
- Do not edit output files, queue files, or cost logs unless the user explicitly asks.