# pi-workstation

Custom extensions and themes for [pi coding agent](https://github.com/badlogic/pi-mono).

![screenshot](assets/screenshot.png)

![demo](assets/demo.gif)

## Extensions

### Navi
Animated companion entity that lives below the editor. Has moods (idle, thinking, happy, excited, sleeping), a particle field driven by music VJ data, and feeds from Wikipedia, Hacker News, and RSS. Levels up based on token usage.

### Music
Full music player inside the terminal. Supports YouTube, Mixcloud, Bandcamp, and NTS Radio. Search, queue, favorites, history, watchlists. Exposes real-time audio analysis (energy, beat, transients, spectral flux) as VJ data for other extensions. Uses mpv and yt-dlp.

### Knowledge Graph
Feed URLs to a graph that extracts entities and relationships, indexes them, and makes them searchable. The agent can query it during sessions as a second brain.

### LLM Council
Multiple models work on the same problem in parallel, then a chairman synthesizes the results. Supports custom templates for security audits, architecture reviews, and exploratory research.

### Git
Full interactive git TUI. Diff viewer, status with per-file staging, scrollable commit graph, stash operations, branch management, merge, and rebase — all without leaving the agent session.

### Files
IDE-style file browser. `/files` for tree navigation with git status, `/find` for fuzzy file search (Ctrl+P style), `/grep` for full-text search, plus inline editing, syntax-highlighted preview, and a diff viewer.

### Project Manager
Kanban board stored in the repo at `.pi/project-board.json`. The agent can read and update issues, so it knows what's in progress without re-explaining context.

### Background Tasks
Run long commands (builds, deploys, test suites) in the background with automatic log capture and exit code tracking.

### Output Guard
Catches the agent before it does something destructive.

### Tmux Tabs
Manages multiple terminal sessions from within the agent.

### Notify
Desktop notifications for session events.

### TPS
Tokens-per-second display.

## Themes

| Theme | Inspiration |
|-------|-------------|
| **terayama** | Shuji Terayama's avant-garde theater. Deep blacks, parchment text, traditional Japanese accent colors (kurenai, fuji, kin, koke, hotaru). |
| **kill-the-past** | Serial Experiments Lain. Static red on pure black with scanline grays and CRT whites. |
| **the-silver-case** | Suda51's detective noir. Blood red, copper, gold, film-grain textures. |
| **y2k-cyber** | Late-90s internet cafe. Electric blue, hot pink, acid green on void-black. |
| **kanagawa** | Inspired by the kanagawa.nvim colorscheme. |
| **kanagawa-contrast** | Higher contrast variant of kanagawa. |
| **plasma** | Vibrant plasma palette. |
| **dusty** | Muted, warm tones. |
| **zen-clear** | Clean, minimal, focused. |

## Installation

```bash
pi install npm:pi-workstation
```

All extensions and themes will be automatically available after installation.

To activate a theme, set it in your `~/.pi/agent/settings.json`:

```json
{
  "theme": "terayama"
}
```

### Dependencies

Some extensions require external tools:

- **Music**: [mpv](https://mpv.io/) and [yt-dlp](https://github.com/yt-dlp/yt-dlp)
- **Files / Git**: [fd](https://github.com/sharkdp/fd) and [rg](https://github.com/BurntSushi/ripgrep) (bundled with pi)

## Known Issues

- **Music flickering** — Playing music can cause screen flickering. Running pi inside tmux resolves this.
- **Files / Git preview truncation** — When browsing files in `/files` or `/git`, the first N lines of file content may not be displayed.

## License

MIT