Repository navigation
First Release
·
46 commits
to master
since this release
opencode plugin add @jakedowns/progress-tool-opencode-plugin@^2.18.0@jakedowns/progress-tool-opencode-plugin
First release! An OpenCode plugin that gives agents a fire-and-forget progress tool and an out-of-band relay for long-running commands — a live, glance-able tree above the transcript, at zero model tokens for telemetry.
Features
progresstool — dual purpose: a drop-in replacement for todo/task trackers (tree of tasks, parent/child roll-up) and a milestone reporter.listtool — read-only view of your session's trees, with dismissed items hidden.progress-relay— wraps long commands so stdout/stderr drive the UI (progress-relay --id build-1 -- npm run build); exit code maps to done/error, andOSC 9;4progress sequences are parsed natively.- Desktop pill —
(N · agg%)title, collapsible animated trees, dismissals that persist, started/last-updated tooltips, and nudge telemetry. - Guidance that adapts — injected progress/relay rules, skill playbooks, pre-flight relay hints, strict-mode nudges for silent runs and stale progress, a turn-end idle reminder, and an optional 2-minute wall-clock nudge.
- Subagent attribution — child work rolls up under the parent session, so it shows in the parent's pill instead of an orphaned scope.
- Four bundled skills —
progress-tool,delegation,osc-demo, andtree-demo, registered automatically. - Automatic MCP registration — installs and registers
@jakedowns/progress-tool-mcpfor you, with runtime detection (node→bun→npx -y @jakedowns/progress-tool-mcp) and anmcpRuntimeoption to pin the path. - Configurable — options for instruction injection, skill registration, MCP auto-registration, strict mode, wall-clock and idle nudges, auto-hide of completed tasks, bar style (
blocks/emoji), refresh interval, and verbose JSONL telemetry. - Persistent state — lives in
~/.opencode-progress-state.json, with opt-in retention (PROGRESS_AUTO_PRUNE_S) so the store doubles as a report.
Links
- npm: @jakedowns/progress-tool-opencode-plugin on npmjs
- Repository & full docs: https://github.com/jakedowns/progress-tool
- License: MIT
💛 Support
If this plugin saves you time, donations are greatly appreciated — they keep it maintained and improving:
Feedback & issues: found a bug, have an idea, or want a feature? Open an issue — reports and suggestions are welcome.
If you like it or find it useful, please ⭐ star the repo and share it on social media — it's the easiest way to help more people discover it.
