pi-catppuccin-themes

Pi themes. The four Catppuccin flavors (latte, frappe, macchiato, mocha) vendored in-house so no third-party install is needed.

Packages

Package details

theme

Install pi-catppuccin-themes from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-catppuccin-themes
Package
pi-catppuccin-themes
Version
0.1.0
Published
Sep 4, 2026
Downloads
136/mo · 16/wk
Author
derangga
License
MIT
Types
theme
Size
13.2 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "themes": [
    "./themes/catppuccin-frappe.json",
    "./themes/catppuccin-latte.json",
    "./themes/catppuccin-macchiato.json",
    "./themes/catppuccin-mocha.json"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-catppuccin-themes

Catppuccin themes for the Pi coding agent, vendored in-house so installing them never pulls a third-party repo:

  • 🌻 Latte (light)
  • 🪴 Frappé (dark)
  • 🌺 Macchiato (dark)
  • 🌿 Mocha (dark)

Installation

Install from npm, then pick a flavor in Pi via /settings:

pi install pi-catppuccin-themes

Or copy the files by hand into your Pi themes directory:

cp node_modules/pi-catppuccin-themes/themes/catppuccin-*.json ~/.pi/agent/themes/

Accent color

The accent is a single reference at the top of colors in each theme file. To change it, edit the installed file under ~/.pi/agent/themes/:

"accent": "rosewater"

Any of the 26 palette roles works: rosewater, flamingo, pink, mauve, red, maroon, peach, yellow, green, teal, sky, sapphire, blue, lavender, text, subtext1, subtext0, overlay2, overlay1, overlay0, surface2, surface1, surface0, base, mantle, crust. Pi watches the themes directory and applies the edit without a restart.

Design notes

Theme values follow the official Catppuccin palette, except the tool success/error backgrounds use the convention from catppuccin/delta (subtle 20% color mixes, stored as literal hex so they render without palette resolution).

Credits

Ported from otahontas/pi-coding-agent-catppuccin. The palette itself is © Catppuccin, MIT licensed; see catppuccin/catppuccin for details.

License

MIT. See LICENSE.