awesome-pi-themes

A curated collection of 28 original dark themes for Pi Coding Agent with a live web preview

Packages

Package details

theme

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

npm repo home report

$ pi install npm:awesome-pi-themes

Package: awesome-pi-themes
Version: 1.1.1
Published: Jul 30, 2026
Downloads: 1,026/mo · 1,026/wk
Author: isashi
License: MIT
Types: theme
Size: 83.3 KB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "themes": [
    "./themes"
  ],
  "image": "https://raw.githubusercontent.com/isashi/awesome-pi-themes/main/docs/screenshots/starry-night.jpg"
}

Security note

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

README

Awesome Pi Themes

A curated collection of 28 original dark themes for pi, with a standalone browser preview and ready-to-copy JSON theme files.

The goal of this project is to make pi feel more personal and readable during real coding sessions. Feedback is very welcome, especially on contrast, syntax colors, warnings/errors, diffs, and long-session readability.

Preview

Browse the live gallery:

https://isashi.github.io/awesome-pi-themes/

Featured theme:

Install

Install all themes from npm

pi install npm:awesome-pi-themes

Then select a theme from /settings, or set it in your pi settings file:

{
  "theme": "princess-nam-rom"
}

Install one theme manually

mkdir -p ~/.pi/agent/themes
curl -fsSL https://raw.githubusercontent.com/isashi/awesome-pi-themes/main/themes/princess-nam-rom.json \
  -o ~/.pi/agent/themes/princess-nam-rom.json

Then select princess-nam-rom from /settings, or set it as your active theme.

Try a local theme without installing it

pi --theme ./themes/princess-nam-rom.json

Themes

Click a name to open the live preview for that theme.

Theme	Screenshot
alien-candy
arctic-aurora
breezy-ocean
cosmic-lagoon
crimson-noir
cyber-mint
dragon-lulu
ember-sunset
enchanted-forest
glitch-carnival
golden-dusk
laser-swamp
lavender-mist
meomeo-mang
midnight-orchid
neon-sakura
noodle-nebula
paper-moon
plasma-pomegranate
princess-nam-rom
quantum-pickle
radioactive-lullaby
rainbow-prism
starry-night
static-dragonfruit
tuscan-sun
velvet-meteor
volcanic-bubblegum

Feedback wanted

If you try these themes, please open an issue with notes about:

readability during longer coding sessions
low-contrast text, borders, warnings, or errors
confusing diff colors
themes you would add, remove, rename, or tune
screenshots or terminal/font combinations where a theme looks worse than expected

Issues: https://github.com/isashi/awesome-pi-themes/issues

Local development

Requirements:

Node.js 18+
npm

Install dependencies:

npm install

Run the local preview server:

npm run preview

Build the static GitHub Pages site:

npm run build

Validate the project:

npm run check

Add a new theme

Create a JSON file in themes/, for example themes/my-theme.json.
Make sure the theme name matches the file slug, for example my-theme.
Run:

npm run check
npm run build

Commit the theme and regenerated docs/index.html.

Project structure

awesome-pi-themes/
  preview-themes-web.js
  package.json
  README.md
  themes/
    *.json
  docs/
    index.html
    screenshots/
      *.jpg

Changelog

See CHANGELOG.md.

License

MIT