Repository navigation
v0.2.0 — completion hooks
completion hooks
- configure a startup hook with
--on-complete 'command'. - register or replace one at runtime with
@on-complete commandor{"type":"on_complete","command":"..."}over the socket or stdin. - agents can register
tmux kill-pane -t <captured-pane-id>once and have their progress pane close automatically at completion. - hooks fire once when the actual value reaches or exceeds a positive total. repeated completion updates do not repeat the hook; resets preserve and re-arm it. an empty command clears it.
- late registration on an already completed run fires immediately if no hook has fired. partial eof or cancellation does not trigger a hook.
commands run through /bin/sh -c without stdin, with output sent to stderr. hooks execute serially without blocking redraws. orderly shutdown, including ctrl-c, waits for queued hooks, and hook failures make the eventual exit nonzero. hooks have no timeout and must finish on their own. pane removal can terminate its subprocesses: put other cleanup before tmux kill-pane, or leave it to the caller.
other changes
- socket permissions are now
0600; keep the socket directory private and accept only trusted producers, since clients can configure shell commands. - the bundled agent skill now registers exact-pane automatic cleanup and verifies pane removal.
- updated documentation and tests for completion, resets, eof, runtime updates, and hook failures.
- bundled plugin version is now
0.2.0.
downloads
macos (darwin) and linux archives are available for amd64 and arm64. apple silicon uses darwin_arm64; intel macs use darwin_amd64. extract the matching archive and run ./progress-bar-3000 --help; go is not needed for prebuilt binaries.
archives include the executable, readme, license, demos, and agent skill/plugin manifest. verify downloads against checksums.txt using sha256sum -c checksums.txt on linux or shasum -a 256 -c checksums.txt on macos; entries for archives you did not download report missing files.
native macos arm64 execution was checked. other platforms were cross-compiled and inspected but not run on target systems. macos binaries are not notarized.