@async23/pi-tmux-window-wrap

Report Pi agent activity to aipane's tmux-window-wrap status indicator

Packages

Package details

extension

Install @async23/pi-tmux-window-wrap from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@async23/pi-tmux-window-wrap
Package
@async23/pi-tmux-window-wrap
Version
0.1.0
Published
Jul 31, 2026
Downloads
87/mo · 7/wk
Author
async23
License
MIT
Types
extension
Size
6.9 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/index.ts"
  ]
}

Security note

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

README

@async23/pi-tmux-window-wrap

Report Pi's foreground agent activity to aipane's tmux-window-wrap status indicator.

Features

  • Marks the current tmux pane busy when Pi emits agent_start.
  • Keeps the marker busy across retries, compaction, and queued follow-ups.
  • Clears the marker on agent_settled, startup, and shutdown.
  • Uses aipane's pane-local marker, so stale state is ignored after the pane command changes.
  • Becomes a silent no-op outside tmux or when the helper is unavailable.
  • Provides /tmux-window-wrap-test for a visible 1.2-second indicator pulse.

Requirements

  • Pi coding agent
  • tmux
  • aipane's tmux-window-wrap helper with activity busy|idle support

The default helper location is:

~/.local/bin/tmux-window-wrap

It should point to aipane's canonical script:

ln -sf "$HOME/code/demo/aipane/bin/tmux-window-wrap" \
  "$HOME/.local/bin/tmux-window-wrap"

Install

pi install npm:@async23/pi-tmux-window-wrap

Restart Pi after installation, or run /reload in an existing session.

For local development:

pi install /absolute/path/to/pi-packages/packages/tmux-window-wrap

Verify

Run this inside a Pi session under tmux:

/tmux-window-wrap-test

The current window label should display an animated ▓ for 1.2 seconds.

Normal lifecycle mapping:

Pi event Marker
session_start idle
agent_start busy
agent_settled idle
session_shutdown idle

agent_settled is intentionally used instead of agent_end: it fires only after retries, compaction, and queued continuations have finished.

Configuration

Override the helper executable when aipane is installed elsewhere:

export PI_TMUX_WINDOW_WRAP_BIN=/path/to/tmux-window-wrap

Uninstall

pi remove npm:@async23/pi-tmux-window-wrap

License

MIT