smoose-pi-themes

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

原始内容

# pi-themes

A theme pack for [pi](https://github.com/earendil-works/pi), with file-based switching for paired light/dark theme families.

## Installation

```bash
pi install npm:@smoose/pi-themes
```

This package currently includes Everforest, Tundra, Rosé Pine, OneDark, Gruvbox, and Bearded Arc. Paired theme families can follow the `<family>-light` / `<family>-dark` naming convention; standalone themes can be selected by concrete theme name in the control file.

## Included themes

### Everforest

- `everforest-dark`
- `everforest-light`

### Tundra

Extracted from [`sam4llis/nvim-tundra`](https://github.com/sam4llis/nvim-tundra)'s arctic palette and stylesheet:

- `tundra-dark`

### Rosé Pine

Extracted from the official [Rosé Pine palette](https://rosepinetheme.com/palette/ingredients/):

- `rosepine-dark`
- `rosepine-light`

### OneDark

Extracted from [`navarasu/onedark.nvim`](https://github.com/navarasu/onedark.nvim)'s palette styles:

- `onedark-dark`
- `onedark-light`

### Gruvbox

Extracted from [`morhetz/gruvbox`](https://github.com/morhetz/gruvbox)'s medium-contrast palette:

- `gruvbox-dark`
- `gruvbox-light`

### Bearded Arc

Extracted from [`BeardedBear/bearded-theme`](https://github.com/BeardedBear/bearded-theme)'s Arc variation:

- `bearded-arc-dark`

## How switching works

The running pi extension watches a small control file. When the file changes, the extension reads it and calls `ctx.ui.setTheme(...)` inside pi.

The extension also sets a footer/status key named `pi-themes`, which can be consumed or styled together with other footer plugins.

Default control file:

```text
~/.pi/agent/pi-theme.json
```

Override it with:

```bash
PI_THEME_CONTROL_FILE=/path/to/pi-theme.json
```

## Control file format

Select a paired theme family and appearance:

```json
{
  "family": "everforest",
  "appearance": "dark"
}
```

This switches to:

```text
everforest-dark
```

Set a concrete theme directly:

```json
{
  "theme": "tundra-dark"
}
```

External tools can write this file however they like, for example:

```bash
mkdir -p ~/.pi/agent
printf '{"family":"everforest","appearance":"dark"}\n' > ~/.pi/agent/pi-theme.json
printf '{"theme":"tundra-dark"}\n' > ~/.pi/agent/pi-theme.json
```

## Pi command

Inside pi, theme-family control is also available through:

```text
/theme everforest        # defaults to everforest-dark
/theme everforest light
/theme rosepine light
/theme tundra            # defaults to tundra-dark
```

The command format is:

```text
/theme <family> [dark|light]
```

If `dark` or `light` is omitted, `dark` is used. The command only requires the target concrete theme to exist, so dark-only families like `tundra-dark` are supported.

## Environment

```bash
PI_THEME=everforest
PI_THEME_CONTROL_FILE=~/.pi/agent/pi-theme.json
```

`PI_THEME` sets the default family used when the `/theme` command omits a family-specific context. File-based switching itself is driven by the control file.

pi-themes

A theme pack for pi, with file-based switching for paired light/dark theme families.

Installation

pi install npm:@smoose/pi-themes

This package currently includes Everforest, Tundra, Rosé Pine, OneDark, Gruvbox, and Bearded Arc. Paired theme families can follow the <family>-light / <family>-dark naming convention; standalone themes can be selected by concrete theme name in the control file.

Included themes

Everforest

everforest-dark
everforest-light

Tundra

Extracted from sam4llis/nvim-tundra's arctic palette and stylesheet:

tundra-dark

Rosé Pine

Extracted from the official Rosé Pine palette:

rosepine-dark
rosepine-light

OneDark

Extracted from navarasu/onedark.nvim's palette styles:

onedark-dark
onedark-light

Gruvbox

Extracted from morhetz/gruvbox's medium-contrast palette:

gruvbox-dark
gruvbox-light

Bearded Arc

Extracted from BeardedBear/bearded-theme's Arc variation:

bearded-arc-dark

How switching works

The running pi extension watches a small control file. When the file changes, the extension reads it and calls ctx.ui.setTheme(...) inside pi.

The extension also sets a footer/status key named pi-themes, which can be consumed or styled together with other footer plugins.

Default control file:

~/.pi/agent/pi-theme.json

Override it with:

PI_THEME_CONTROL_FILE=/path/to/pi-theme.json

Control file format

Select a paired theme family and appearance:

{
  "family": "everforest",
  "appearance": "dark"
}

This switches to:

everforest-dark

Set a concrete theme directly:

{
  "theme": "tundra-dark"
}

External tools can write this file however they like, for example:

mkdir -p ~/.pi/agent
printf '{"family":"everforest","appearance":"dark"}\n' > ~/.pi/agent/pi-theme.json
printf '{"theme":"tundra-dark"}\n' > ~/.pi/agent/pi-theme.json

Pi command

Inside pi, theme-family control is also available through:

/theme everforest        # defaults to everforest-dark
/theme everforest light
/theme rosepine light
/theme tundra            # defaults to tundra-dark

The command format is:

/theme <family> [dark|light]

If dark or light is omitted, dark is used. The command only requires the target concrete theme to exist, so dark-only families like tundra-dark are supported.

Environment

PI_THEME=everforest
PI_THEME_CONTROL_FILE=~/.pi/agent/pi-theme.json

PI_THEME sets the default family used when the /theme command omits a family-specific context. File-based switching itself is driven by the control file.