pi-terminal-theme

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# 🖥️ pi-terminal-theme

> [!IMPORTANT]
> **Sunset notice:** As of pi v0.79.7, pi supports automatic light/dark
> theme mode natively. This package is no longer needed for that workflow and
> is sunsetted. Prefer explicit light/dark theme pairs such as
> `"theme": "github-light/github-dark"` in `~/.pi/agent/settings.json`.

Your terminal colors are fine. Stop overriding them.

This [pi](https://github.com/earendil-works/pi-mono/tree/main/packages/coding-agent)
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

```sh
pi install npm:pi-terminal-theme
```

## ✨ Usage

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

```json
{
  "theme": "terminal"
}
```

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

```json
{
  "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](https://github.com/mavam/pi-terminal-theme/tree/HEAD/LICENSE)

🖥️ pi-terminal-theme

[!IMPORTANT] Sunset notice: As of pi v0.79.7, pi supports automatic light/dark theme mode natively. This package is no longer needed for that workflow and is sunsetted. Prefer explicit light/dark theme pairs such as "theme": "github-light/github-dark" in ~/.pi/agent/settings.json.

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:

🎨 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