@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