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.