---
slug: "pi-theme-picker"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/ldelossa/pi-theme-picker@main/README.md"
repo: "https://github.com/ldelossa/pi-theme-picker"
source_file: "README.md"
branch: "main"
---
# pi-theme-picker

Pi extension that adds a `/theme` command for switching between installed Pi themes.

## Install

After this package is published:

```bash
pi install npm:pi-theme-picker
```

For local development before publishing:

```bash
pi install /home/louis/git/js/pi-theme-picker
# or test for one run:
pi -e /home/louis/git/js/pi-theme-picker
```

## Usage

```text
/theme              # open an interactive, fuzzy-searchable theme picker
/theme nord         # switch directly to a theme by name
```

Inside the picker, type to fuzzy-filter themes, use backspace to edit the search, and press `ctrl+u` to clear it.

The highlighted theme is live-previewed as you navigate. Press `enter` to apply and persist it to Pi's global `settings.json`, or `esc` to cancel and restore the original theme.

## Notes

- This package ships the picker extension only; it does not bundle theme JSON files.
- Themes are discovered through Pi's theme registry, including built-in, global, project-local, settings, CLI, and package-provided themes.