@hank-warren/pi-statusline
v0.1.0
Published
Compact Pi footer statusline: model ID, git branch/dirty/behind state, linked worktrees with PR numbers, context usage, and session ID.
Maintainers
Readme
pi-statusline
Replaces Pi's default footer with a compact statusline:
gpt-5.6-sol | pi-extensions:main* ⇣1 | 40k/1.0m
⑂ pi-extensions:feature/statusline* ⇣2 #7 | infra:fix/alerts #168
019fafa7-29c0-7e99-9f82-5794d5721848What it shows
- Line 1 — active model ID, current directory basename and Git branch, and current context usage/window. A yellow
*marks a dirty checkout and⇣Nshows how many commits it is behind its locally known upstream ref. Unknown context usage is rendered as?/<window>until Pi can provide an estimate. - Worktree lines — when the session works in or sends tool calls into linked worktrees, one line shows the same branch/dirty/behind state for each worktree plus its associated PR number.
- Final line — the full Pi session ID.
It uses a fixed true-color palette with context warning thresholds.
Worktree/PR tracking behavior
- Only worktrees touched on the active Pi session branch are included.
- Worktree paths appearing only inside Bash heredoc payloads are ignored.
- Merged and closed PR worktrees are hidden.
- State is rebuilt on reload and tree navigation; deleted worktrees are pruned.
- Git state refreshes after each turn; branches without a PR are rechecked every five seconds; existing PR metadata is cached for five minutes.
PR lookups use the gh CLI when available and degrade gracefully without it.
Install
pi install npm:@hank-warren/pi-statuslineLicense
MIT — see LICENSE.
