pi-titlebar-spinner

A pi extension that sets the terminal title to π and animates a braille spinner while the agent is working

Packages

Package details

extension

Install pi-titlebar-spinner from npm and Pi will load the resources declared by the package manifest.

npm home report

$ pi install npm:pi-titlebar-spinner

Package: pi-titlebar-spinner
Version: 0.0.1
Published: Jul 18, 2026
Downloads: 121/mo · 121/wk
Author: richardanaya
License: MIT
Types: extension
Size: 5.7 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

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.

pi-titlebar-spinner

Install

Behavior

License