pi-loader ⠿

Braille-dot working indicator for pi coding agent.

Replaces the default spinner with rich 2-character braille animations. 54+ patterns including helixes, neural flickers, sweeps, snakes, and more — all in pure ASCII-compatible Unicode braille.

Demo: preview gallery, pattern switching, speed & color controls

Installation

Via pi (recommended)

pi install npm:@graedenn/pi-loader

Then /reload or restart pi.

Manual

mkdir -p ~/.pi/agent/extensions/pi-loader
cp index.ts patterns.ts ~/.pi/agent/extensions/pi-loader/
/reload

Usage

Command	Description
/loader pattern <name>	Switch animation pattern
/loader color <color>	Set color (name, #hex, or 0-255 ANSI)
/loader speed <n>	Set speed multiplier (0.25–10.0)
/loader preview	Interactive gallery with live preview
/loader reset	Restore defaults
/loader off / on	Disable / re-enable

Preview mode

/loader preview opens an interactive picker:

Key	Action
← →	Switch pattern
↑ ↓	Adjust speed
[ ]	Cycle color
Enter	Select and apply
Esc	Close

Named colors: accent, muted, dim, text, success, warning, error, border, borderAccent

All Patterns

Key	Name	Frames
default	Default	10
single-dots	Single Dots	8
single-bounce	Single Bounce	14
single-fill	Single Fill	14
single-sweep	Single Sweep	8
half-helix	Half Helix	16
helix-core	Helix Core	12
helix-glow	Helix Glow	20
thought-helix	Thought Helix	19
pulse-ladder	Pulse Ladder	16
core-spiral	Core Spiral	16
twin-orbit	Twin Orbit	16
infinity-run	Infinity Run	20
radar-arc	Radar Arc	20
scan	Scan	6
sweep	Sweep	13
agent-sweep	Agent Sweep	19
sound-bars	Sound Bars	16
perimeter-spin-light	Perimeter Spin Light	12
perimeter-spin	Perimeter Spin	12
perimeter-spin-bold	Perimeter Spin Bold	12
shuffle	Shuffle	7
hangtime	Hangtime	57
line-spin	Line Spin	8
ray-spin	Ray Spin	8
rotating-x	Rotating X	4
texture-flip	Texture Flip	2
neural-flicker	Neural Flicker	15
neural-flicker-chaos	Neural Flicker Chaos	43
neural-flicker-drift	Neural Flicker Drift	41
neural-flicker-thought	Neural Flicker Thought	41
neural-scatter	Neural Scatter	16
neural-spike	Neural Spike	14
neural-random-walk	Neural Random Walk	16
neural-cross-spark	Neural Cross Spark	14
neural-offset	Neural Offset	14
neural-braid	Neural Braid	18
thinking-pulse	Thinking Pulse	21
soft-thinking	Soft Thinking	16
deep-thought	Deep Thought	23
signal-search	Signal Search	15
binary-thought	Binary Thought	13
center-spark	Center Spark	12
synapse-wave	Synapse Wave	20
inner-current	Inner Current	13
bouncing-block	Bouncing Block	12
face	Smiley Face	6
snake-crawl	Snake Crawl	30
snake-loop	Snake Loop	24
circle	Circle	6
square	Square	2
twinkle	Twinkle	2
corners	Corners	4
growth	Growth	10

Adding Patterns

Add new patterns in patterns.ts as type: "raw" entries. Each frame is 1–2 braille characters. Use braille-chars.txt as a reference for encoding.

"my-pattern": {
  type: "raw",
  name: "My Pattern",
  frames: ["⠋⠙", "⠹⠸", "⠼⠴"],
  defaultSpeed: 1.0
}

License

MIT