# pi-panels

![pi-panels screenshot](assets/screenshot.png)

Responsive status panels rendered below the editor in [pi](https://pi.dev). Three panels ship out of the box, each independently toggleable:

- **GIT** - worktree name, branch, upstream tracking (shown only when non-default), ahead/behind counts
- **INFO** - LLM context usage bar (color-coded from green to red as you approach the context window limit), active model and thinking level
- **NOW PLAYING** - Spotify track, artist, and progress bar with animated fill (hidden automatically when Spotify is not running)

Panels auto-size to their content, render side-by-side when terminal width allows, and fall back to a stacked layout on narrow terminals.

## Install

```bash
pi install npm:@alasano/pi-panels
```

## Commands

| Command                  | Description                                           |
| ------------------------ | ----------------------------------------------------- |
| `/status-panels`         | Open the settings overlay to toggle individual panels |
| `/status-panels on\|off` | Enable or disable all panels                          |

## Settings overlay

Running `/status-panels` with no arguments opens a centered overlay where you can enable or disable each panel individually using checkbox toggles. Typing any character dismisses the overlay and passes the keystroke to the editor.

## Preferences

Panel visibility preferences are persisted at `~/.pi/agent/state/extensions/status-panels/config.json` and restored on session start. Default behavior on first run is all panels enabled.

## Refresh behavior

- Git info refreshes every 5 seconds and immediately after each agent turn
- LLM context and model info update on turn end and model switch
- Spotify polls every 1 second while playing, every 2.5 seconds when idle
- The rendering loop ticks every 250ms to keep the Spotify progress bar smooth

## Requirements

- macOS (Spotify integration uses osascript/AppleScript)
- Pi interactive mode (panels use the widget API which is unavailable in print/RPC mode)