pi-catppuccin

Catppuccin's four flavours for the Pi agent harness, adapted with a focus on a calm, muted experience.

🛠️ Usage

Install the package from npm:

pi install npm:pi-catppuccin

Open /settings in Pi and choose your favourite flavour. That's it — save and enjoy!

Flavour	Theme	Mood
🌻 Latte	catppuccin-latte	Light, bright, and tuned for comfortable contrast.
🪴 Frappé	catppuccin-frappe	Soft and muted.
🌺 Macchiato	catppuccin-macchiato	Rich, balanced, and suited to everyday use.
🌿 Mocha	catppuccin-mocha	The deepest and coziest of the bunch.

Want Pi to follow your terminal's light and dark appearance? Pair two flavours in ~/.pi/agent/settings.json:

{
  "theme": "catppuccin-latte/catppuccin-macchiato"
}

Pi will use Latte for light terminals and Macchiato for dark ones.

Trying it locally

You can take the themes for a spin without changing your settings:

pi -e /absolute/path/to/pi-catppuccin

Updating or removing

pi update npm:pi-catppuccin
pi remove npm:pi-catppuccin

✨ About

This port keeps Pi calm and readable while still feeling unmistakably Catppuccin:

• Mauve at heart. All four flavours use mauve as their accent rather than shipping every flavour/accent combination.
• Quiet chrome. Surface and Overlay colors keep borders and everyday UI out of the way.
• Clear states. Semantic colors are saved for warnings, errors, diffs, and other meaningful moments.
• A gentle thinking gradient. Pi's thinking border moves from neutral surfaces toward mauve as reasoning increases.
• Readable Latte. Text-facing accents are slightly darkened where the stock palette would be too faint on a light background.

Most colors come directly from the official Catppuccin palette. Whiskers derives only the raised panels, error tint, thinking gradient, and Latte readability adjustments.

🧑‍💻 Development

catppuccin.tera is the source of truth. The JSON themes are generated and committed so Pi can install this repository directly — please don't edit them by hand.

nix shell nixpkgs#catppuccin-whiskers --command whiskers catppuccin.tera
nix shell nixpkgs#catppuccin-whiskers --command whiskers catppuccin.tera --check
npm run check

Automated checks keep generated files in sync and smoke-test the package. A visual check is still worthwhile, especially with Latte and Macchiato.

💝 Thanks

• Catppuccin for the palette
• Whiskers for generation
• Pi for the theme and package system
• otahontas/pi-coding-agent-catppuccin and scarcekoi/pi for visual and tooling inspiration

Released under the MIT License.