pi-zero

A curated pi extension suite that combines the best of pi-powerline-footer and pi-cc-extensions into a single, lean package — without bash mode, queue, stash, shortcuts, welcome page, or other extras.

Features

Module	Feature	Entry
powerline	Powerline-style status bar (git branch, token usage, model, context %)	automatic
vibe	Random themed working-message (file or generate mode), merged with token / elapsed-time stats	automatic
context	Context-window usage inspector with System Prompt / Tools / Skills preview	/context
ccstyle	Claude Code style tool rendering (collapse / compact / animation / rich diff) + compact thinking	/ccstyle
shared	Generic helpers (getAgentPath, showTextPreview) shared across modules	—

Install

Install from npm as a pi package:

pi install npm:@zerosnow/pi-zero

Then run /reload in the pi TUI.

Requires Node.js >= 22.19.

Commands

Command	Description
/context	Show context-window distribution; press Enter/click to preview parts
/ccstyle [on|off|compact|status|panel]	Switch or configure Claude Code style tool rendering
/vibe [theme|off|mode|model|generate]	Configure the working-message vibe
/powerline [on|off|preset|placement]	Toggle the status bar on/off, or set its preset / placement

Configuration

Global config lives in ~/.pi/agent/settings.json. pi-zero reads these keys:

• workingVibe, workingVibeMode, workingVibeModel — vibe theme, mode (file/generate), model
• powerline — status bar preset, placement, disabledSegments, customItems, etc.
• workingVibeShimmer — shimmer sweep animation (handled by a separate local extension)

Runtime dependencies

compact-thinking needs jiti (regular dependency) and pi-compact-thinking (a pi package, shipped as a bundled dependency). When installed via pi install npm:@zerosnow/pi-zero, pi runs npm install, so these are installed automatically — no manual setup needed.

Syntax highlighting for write diffs is provided by @shikijs/cli, shipped as an optional dependency. When it is available, ccstyle colors code blocks in diff previews; if it cannot be installed, highlighting gracefully falls back to plain rendering.

Structure

pi-zero/
├── index.ts            entry (loaded by pi auto-discovery)
├── shared/             generic helpers shared across modules
├── powerline/          status bar
├── vibe/               random working-message
├── context/            /context inspector
└── ccstyle/            Claude Code style tool rendering (+ tool-diff/)

Compatibility & Notes

• ccstyle patches pi's tool rendering (similar to fixed-editor); if you ever see layout issues, run /ccstyle off to fall back to native rendering.
• Long-session responsiveness. compact-thinking's thinking preview is cached by content, so typing and deletion stay responsive even in very long sessions with many large thinking blocks.
• Fixed editor is not included, and the fixed-editor-only tool-mouse interaction (hover/click/scroll affordances) has been removed.
• Multiple pi processes are isolated: state is process-local (global symbols), and session boundaries are cleaned on session_start.

Acknowledgements

• Status bar, vibe: adapted from pi-powerline-footer (MIT)
• ccstyle, /context, token/time stats: adapted from pi-cc-extensions (Proprietary)
• Rich diff: adapted from pi-tool-display (MIT) — see ccstyle/tool-diff/ATTRIBUTION.md

License

MIT (for the pi-zero-specific composition; see individual attributions above).