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