pi-cat-loader

Animated rolling cat loader for pi. Replaces pi's inline spinner with cat animation and adds /cat-loader command controls.

Compatibility

This extension requires a terminal with inline image support. Known terminals that work include:

• Ghostty
• Kitty
• WezTerm
• iTerm2

This extension does not work inside tmux. When tmux is detected, the cat loader is automatically disabled and pi falls back to its regular spinner.

Installation

pi install npm:@kyuc/pi-cat-loader

Commands

/cat-loader on                    Enable cat loader
/cat-loader off                   Disable cat loader
/cat-loader preview               Show cat loader for 5 seconds
/cat-loader clear                 Clear terminal images
/cat-loader size <value>          Set width (small, medium, large, or 1-20)
/cat-loader color <color>         Set color (classic, black, gray, white, yellow)
/cat-loader help                  Show help

Configuration

Settings are saved under pi's catLoader config key. You can change these through /cat-loader commands, or edit pi settings directly:

{
  "catLoader": {
    "enabled": true,
    "sizeCells": 4,
    "color": "classic"
  }
}

sizeCells must be 1-20. color must be classic, black, gray, white, or yellow.