Awesome Pi Themes

A curated collection of 46 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

This uses pi's documented theme directory, honoring PI_CODING_AGENT_DIR when set.

PI_AGENT_DIR="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
mkdir -p "$PI_AGENT_DIR/themes"
curl -fsSL "https://raw.githubusercontent.com/isashi/awesome-pi-themes/main/themes/princess-nam-rom.json" \
  -o "$PI_AGENT_DIR/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 | | | aurora-circuit | | | basalt-bloom | | | breezy-ocean | | | cinder-grove | | | cosmic-lagoon | | | copper-comet | | | crimson-noir | | | cyber-mint | | | dragon-lulu | | | eclipse-tide | | | ember-sunset | | | enchanted-forest | | | glitch-carnival | | | golden-dusk | | | iron-lotus | | | laser-swamp | | | lavender-mist | | | meomeo-mang | | | midnight-orchid | | | moonlit-terrace | | | moss-mirage | | | neon-sakura | | | nocturne-garden | | | noodle-nebula | | | obsidian-harbor | | | opal-matrix | | | paper-moon | | | plasma-pomegranate | | | polar-lantern | | | princess-nam-rom | | | quantum-pickle | | | radioactive-lullaby | | | rainbow-prism | | | sable-citadel | | | sapphire-ember | | | starry-night | | | static-dragonfruit | | | stormglass-forge | | | tuscan-sun | | | varigotti-sea | | | velvet-meteor | | | volcanic-bubblegum | | | willow-wraith | | | winter-wisp | |

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

Use the project prompt template for the repeatable add-theme patch release workflow:

/new-theme-patch-release [optional style or name hint]

Build the static GitHub Pages site:

npm run build

Validate the project:

npm run check

Add a new theme

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

npm run check
npm run build

4. 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