@omardev_11/pi-pulse-border

Animates a symmetric-gradient comet along the pi editor border with breathing speed/size and per-cycle color swap.

Packages

Package details

extension

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 calls ctx.ui.setEditorComponent, only the last one wins.
  • No effect when ctx.hasUI is false (non-interactive --print mode).

License

MIT