🖥️ pi-terminal-theme

Your terminal colors are fine. Stop overriding them.

This pi package includes two terminal-first themes:

• terminal maps UI colors to ANSI 0..15. That's the safe default.
• terminal-tinted also uses custom palette slots for message and tool backgrounds.

🚀 Installation

pi install npm:pi-terminal-theme

✨ Usage

Pick terminal in /settings → theme, or configure it in ~/.pi/agent/settings.json:

{
  "theme": "terminal"
}

To opt in to tinted message and tool backgrounds, select terminal-tinted:

{
  "theme": "terminal-tinted"
}

Project-specific settings can use the same theme key in .pi/settings.json.

🔄 No theme switcher needed

Because these themes use your terminal’s palette directly, they automatically follow whatever your terminal is already using (light/dark, custom palettes, scheduled changes, etc.).

That means you usually don’t need a separate theme switcher integration such as:

• https://github.com/mise42/pi-theme-sync
• https://github.com/ferologics/pi-system-theme

🎨 Tinted palette slots

The terminal-tinted theme treats palette slots 16..23 as package-specific UI colors:

Slot	Theme use
16	Selected item background
17	Tool error background
18	Tool success background
19	Tool pending background
20	User message background
21	Custom message background
22	Tool title
23	Tool output

These are not standard dim ANSI colors. If your terminal does not remap these slots, it will use the built-in xterm 256-color cube, which can produce harsh or unreadable backgrounds.

📄 License

MIT