@omardev_11/pi-pulse-border
Animates a symmetric-gradient comet along the pi editor border with breathing speed/size and per-cycle color swap.
Package details
Install @omardev_11/pi-pulse-border from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@omardev_11/pi-pulse-border- Package
@omardev_11/pi-pulse-border- Version
0.3.0- Published
- May 21, 2026
- Downloads
- not available
- Author
- omardev_11
- License
- MIT
- Types
- extension
- Size
- 10.5 KB
- Dependencies
- 0 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./extensions/pulse-border.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@omardev_11/pi-pulse-border
Animates a symmetric-gradient comet along the pi editor's top and bottom border while the agent is working.
- Brightest at the comet's center, fading smoothly to both sides
- Top sweeps left→right, bottom sweeps right→left
- Top and bottom use different colors (cyan + magenta by default)
- After each full cycle the colors swap (what was on top moves to the bottom and vice versa)
- Speed and tail length breathe via slow sine modulation for a dynamic, organic feel
Stops on agent_end (border returns to default color).
Install
pi install npm:@omardev_11/pi-pulse-border
Configuration
| Variable | Default | Description |
|---|---|---|
PI_PULSE_BORDER_TOP_COLOR |
#00d9ff |
Hex color of the top comet (cyan). |
PI_PULSE_BORDER_BOTTOM_COLOR |
#cf30aa |
Hex color of the bottom comet (magenta). |
PI_PULSE_BORDER_MS |
50 |
Frame interval in ms (min 16). |
PI_PULSE_BORDER_SPEED |
1.5 |
Base chars-per-frame speed. |
PI_PULSE_BORDER_TAIL |
32 |
Base comet diameter in chars (full width — half on each side of the head). |
PI_PULSE_BORDER_BASE |
0.1 |
Brightness 0..1 of chars outside the comet (the "idle" tint while working). |
PI_PULSE_BORDER_BREATHE |
0.4 |
Amplitude 0..1 of the sine modulation applied to speed and tail. Set 0 for constant speed/size. |
PI_PULSE_BORDER_COLORS |
unset | Legacy: comma-separated top,bottom. Overrides the two color vars above. |
Compatibility
- Subclasses pi's
CustomEditor. If another extension also callsctx.ui.setEditorComponent, only the last one wins. - No effect when
ctx.hasUIis false (non-interactive--printmode).
License
MIT