pi-idle
Pi extension: shows ✓ in terminal title when idle, spinner (◰◳◲◱) while working, with context-usage percentage beside the checkmark
Package details
Install pi-idle from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-idle- Package
pi-idle- Version
1.0.7- Published
- May 20, 2026
- Downloads
- 963/mo · 963/wk
- Author
- zordok
- License
- MIT
- Types
- extension
- Size
- 26.1 KB
- Dependencies
- 0 dependencies · 0 peers
Pi manifest JSON
{
"extensions": [
"./pi-idle.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-idle
A pi extension that puts a ✓ checkmark in your terminal title when the agent is idle, and a ◰◳◲◱ spinner while it's working — so you can tell at a glance whether pi is done or still thinking.
Title format
| State | Title |
|---|---|
| Idle (≤ 50 % context) | ✓ π - session - project |
| Idle (> 50 % context) | ✓ [63%] π - session - project |
| Idle (≥ 90 % context) | ✓ ![95%]! π - session - project |
| Working | ◰ π - session - project |
| Shutdown | π - session - project |
- The context-usage percentage is shown only beside the checkmark — never during the spinner. It's captured once when the agent finishes, not updated live.
≤ 50 %→ percentage hidden;> 50 %→[N%];≥ 90 %→![N%]!(high-usage warning).- ANSI colours don't work inside terminal-title OSC sequences, so everything is plain text.
Screenshots
| Working | Idle |
|---|---|
 |
 |
Install
From npm:
pi install npm:pi-idle
From GitHub:
pi install git:github.com/ZoRDoK/pi-idle
Test
npm test # single run
npm run test:watch # watch mode
CI runs on every push / PR to master via GitHub Actions.