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.

License

MIT