Skip to content

v0.2.0 — completion hooks

Choose a tag to compare

@atomicstack atomicstack released this 13 Sep 01:36

completion hooks

  • configure a startup hook with --on-complete 'command'.
  • register or replace one at runtime with @on-complete command or {"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.