pi-thought-bubbles

Pi extension: agent thoughts materialise randomly around the screen and fade away

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-thought-bubbles
Package
pi-thought-bubbles
Version
0.1.0
Published
Sep 27, 2026
Downloads
184/mo · 4/wk
Author
simon.helson
License
MIT
Types
extension
Size
19.2 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

pi-thought-bubbles

Agent thoughts materialise randomly around the screen and then fade away.

While the agent is thinking, fragments of its reasoning (the first few words of each sentence) fade in at random screen positions, hover for a moment, and fade back out — like fireflies of cognition.

Install

pi install npm:pi-thought-bubbles

Or try it without installing:

pi -e npm:pi-thought-bubbles

Usage

The extension is active by default in TUI mode whenever the model produces thinking tokens.

Command Action
/thoughts Toggle on/off
/thoughts on / off Explicitly enable/disable
/thoughts test Spawn a test thought
/thoughts status Show current state
/thoughts stress [N] [direct|legacy] Leak-regression harness

How it works

  • message_update exposes assistantMessageEvent, including token-level thinking_delta events. These are accumulated and split into sentences.
  • Each "thought" is a small, single-line overlay exactly the size of the text.
  • "Fading" is simulated by stepping theme colors: dim → muted → tint → muted → dim. Terminals have no alpha channel.
  • Overlays are driven via the public tui.showOverlay() API (captured once per session with a one-time invisible probe), with a legacy fallback for older pi versions.

License

MIT