pi-themes

A collection of major color themes for pi, the coding agent — packaged as a pi extension that also ships a /theme command and Ctrl+Shift+T shortcut to switch themes interactively.

Themes

| Theme | Style | Palette | |---|---|---| | catppuccin-mocha | Dark | Catppuccin Mocha | | catppuccin-latte | Light | Catppuccin Latte | | tokyo-night | Dark | Tokyo Night | | gruvbox-dark | Dark | Gruvbox | | gruvbox-light | Light | Gruvbox | | nord | Dark | Nord | | dracula | Dark | Dracula | | solarized-dark | Dark | Solarized | | solarized-light | Light | Solarized | | one-dark | Dark | Atom One Dark |

Extension Features

| Feature | How | |---|---| | Interactive theme selector | /theme | | Switch directly by name | /theme tokyo-night | | Cycle through all themes | Ctrl+Shift+T | | Active theme in footer | Status indicator | | Tab-complete theme names | /theme <tab> |

Installation

Option A — Local package (recommended)

Add to your project's .pi/settings.json:

{
  "packages": ["./pi-themes"]
}

Or to the global ~/.pi/agent/settings.json (all projects):

{
  "packages": ["/absolute/path/to/pi-themes"]
}

Option B — Try without installing

pi -e ./pi-themes/index.ts

This loads the extension but not the theme JSON files. Copy the themes manually first (see Option C below) if you want the bundled themes available.

Option C — Themes only (no extension)

Copy just the JSON files to a themes directory pi already watches:

# Global
cp pi-themes/themes/*.json ~/.pi/agent/themes/

# Project-local
mkdir -p .pi/themes
cp pi-themes/themes/*.json .pi/themes/

Then select a theme via /settings.

Selecting a Theme

Once installed, use the /theme command or select via /settings:

{
  "theme": "catppuccin-mocha"
}

Requirements

Pi requires a truecolor terminal (24-bit RGB). Check with:

echo $COLORTERM  # should output "truecolor" or "24bit"

Works great with: iTerm2, WezTerm, Kitty, Ghostty, Windows Terminal, VS Code terminal.