@getpipher/agent-status

Pi coding-agent lifecycle state as a colored dot in your tmux window tab — per-window rollup (working/mixed/idle) at a glance, no polling.

Packages

Package details

extension

Install @getpipher/agent-status from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@getpipher/agent-status
Package
@getpipher/agent-status
Version
0.2.4
Published
Jul 28, 2026
Downloads
853/mo · 853/wk
Author
rz1989
License
MIT
Types
extension
Size
16 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/agent-status.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@getpipher/agent-status

Pi coding-agent lifecycle state as a colored dot in your tmux window tab — at-a-glance across all your pi windows, no polling.

A pi coding-agent extension that listens to pi lifecycle events and writes a per-window rollup of all pi panes' state to a tmux window-scoped option, rendered as a single colored dot in the window tab. No animation → no extra status-bar redraws → your existing #(...) status scripts keep their normal cadence.

Inspired by herdr's per-pane state indicator, but targets your existing tmux (window tabs) instead of herdr's sidebar. When pi runs under herdr, this extension defers to herdr's own pi integration.

The dot

A ● prefixed before the window number — color-only, no text, no spinner:

window contains dot
no pi pane (no dot)
all pi panes working 🟢 green
mixed (some working, some idle) 🟡 yellow
all pi panes idle ⚪ grey

e.g. window 3: getpipher with one pi working + one pi idle → ● 3: getpipher (yellow).

Status

v0.2.0 — window-tab dot + per-window rollup (green/yellow/grey/none). Replaces the v0.1.x status-left spinner (which cost status-script re-runs). Non-breaking: the extension writes only pane-local @agent_state + window-scoped @agent_window_state; the snippet defines one new user option @agent_window_dot and never sets status-left/window-status-* — you merge the dot into your own window-status format. See the design spec and v0.2 plan.

Install

Add to ~/.pi/agent/settings.json packages:

"npm:@getpipher/agent-status"

Source the tmux snippet in ~/.tmux.conf and insert the dot at the start of your existing window-status-current-format / window-status-format (merge, don't replace — preserves your tab layout):

source-file ~/local-dev/getpipher/agent-status/tmux/agent-status.tmux
# Prepend #{E:#{@agent_window_dot}} to YOUR existing window-status formats.
# The #I:#W below is just a template — keep your own tab layout:
set -g window-status-current-format "#{E:#{@agent_window_dot}} #I:#W"
set -g window-status-format         "#{E:#{@agent_window_dot}} #I:#W"

Reload tmux (prefix + r or tmux source ~/.tmux.conf). When a pi agent runs in a tmux pane, its window's tab shows a green dot (working); when multiple pi panes are in the same window with mixed states, yellow; when all idle, grey; when no pi is in the window, no dot.

License

MIT