Skip to content

feat(load): animated progress spinner for tmuxp load #1020

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tony merged 6 commits into from
Mar 9, 2026
Merged

feat(load): animated progress spinner for tmuxp load #1020

Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
46cf411
feat(builder[callbacks]): add progress, before_script, script_output,…
tony Mar 8, 2026
ac1f73b
feat(_progress[spinner]): add Spinner, BuildTree, templates, and presets
tony Mar 8, 2026
12e5f12
feat(load[spinner]): wire progress spinner into tmuxp load command
tony Mar 8, 2026
2528c59
test(progress[coverage]): add comprehensive tests for spinner and bui…
tony Mar 8, 2026
2e9f8cd
docs(progress): document progress display, env vars, and API reference
tony Mar 8, 2026
96ede9b
docs(CHANGES): add animated progress spinner entry
tony Mar 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
docs(CHANGES): add animated progress spinner entry 
why: PR 2 needs changelog entry for the progress spinner feature.
what:
- Add "Animated progress spinner" section under What's new
  • Loading branch information
@tony
tony committed Mar 9, 2026
commit 96ede9beeda820d297dbcc1ef83347f742301c2d
16 changes: 16 additions & 0 deletions CHANGES
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,22 @@ $ pipx install --suffix=@next 'tmuxp' --pip-args '\--pre' --force
_Notes on the upcoming release will go here._
<!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->

### What's new

#### Animated progress spinner for `tmuxp load` (#1020)

The `load` command now shows an animated spinner with real-time build progress
as windows and panes are created. Five built-in presets control the display
format (`default`, `minimal`, `window`, `pane`, `verbose`), and custom format
strings are supported via `--progress-format` or `TMUXP_PROGRESS_FORMAT`.

- `--progress-lines N` / `TMUXP_PROGRESS_LINES`: Control how many lines of
`before_script` output appear in the spinner panel (default: 3). Use `0` to
hide the panel, `-1` for unlimited (capped to terminal height).
- `--no-progress` / `TMUXP_PROGRESS=0`: Disable the spinner entirely.
- During `before_script` execution, the progress bar shows a marching animation
and ⏸ icon.

## tmuxp 1.66.0 (2026-03-08)

### Bug fixes
Expand Down