pi-titlebar-spinner

A pi extension that owns the terminal tab/window title:

| State | Title | |-------|--------| | Idle | π - cwd or π - session - cwd | | Busy (agent working) | ⠋ π - cwd cycling braille ⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏ |

Uses ctx.ui.setTitle() on session_start, agent_start, agent_end, and session_shutdown.

Install

npm install -g pi-titlebar-spinner
# or with pi
pi install pi-titlebar-spinner

# local path
pi install /absolute/path/to/pi-titlebar-spinner

# try once without installing
pi -e /absolute/path/to/pi-titlebar-spinner

Behavior

• On session start, sets the title to the π form (same shape as pi’s built-in title).
• While the agent is running (agent_start → agent_end), prefixes a braille spinner frame and advances it every 100ms.
• On agent end / session shutdown, clears the timer and restores the idle π title.

Last writer wins for the terminal title. If another extension also calls setTitle, they will fight; prefer one title owner.

License

MIT © Richard Anaya