pi-umbra-shimmer

A wave of colour running through pi's working indicator, over both the spinner and the text.

The highlight is not one colour. It travels from white down to the theme's own main colour and back, blending the whole way rather than stepping, so the band changes tone while it moves.

Install

pi install npm:pi-umbra-shimmer
node ~/.pi/agent/npm/node_modules/pi-umbra-shimmer/patch.mjs

Then restart pi.

The second line is not optional

pi builds the working indicator with a colour function already in hand, and paints custom spinner frames verbatim without running them through that step at all. Neither point is reachable from the extension API, so this package ships three patches against pi's built bundle. Without them the extension loads and does nothing.

node ~/.pi/agent/npm/node_modules/pi-umbra-shimmer/patch.mjs --check

--check writes nothing and exits 1 when a patch is missing. Run it after every pi update. An update replaces the bundle, so all three patches disappear silently and the shimmer stops without an error.

Nothing here is destructive. Each patch is additive, a patch whose text no longer matches is reported rather than forced, and reinstalling pi returns the bundle to stock. The patched behaviour is gated on the extension being loaded, so the patches alone change nothing.

Set PI_UMBRA_PI if pi lives somewhere this script cannot find it.

pi-umbra-shimmer/
├── checks
│   └── umbra-shimmer.check.ts
├── extensions
│   └── umbra-shimmer.ts
└── patch.mjs

MIT.