pi-workstation

Custom extensions and themes for pi coding agent. Music, Navi, knowledge graph, LLM council, git TUI, file browser, and 9 handcrafted themes.

Package details

← Back
extensiontheme

Install pi-workstation from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-workstation
Package
pi-workstation
Version
0.1.1
Published
Mar 16, 2026
Downloads
79/mo · 25/wk
Author
marv1nnnnn
License
MIT
Types
extension, theme
Size
442.3 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./pi-package/extensions"
  ],
  "themes": [
    "./pi-package/themes"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-workstation

Custom extensions and themes for pi coding agent.

screenshot

demo

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

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:

{
  "theme": "terayama"
}

Dependencies

Some extensions require external tools:

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