@samfp/pi-essentials
v0.1.0
Published
Essential extensions for pi — auto session naming, compact header, clipboard images, image pruning, markdown viewer, screenshots, and subagents.
Readme
pi-essentials
Essential extensions for pi — quality-of-life improvements that every setup should have.
Install
pi install npm:pi-essentialsWhat's Included
| Extension | What it does |
|-----------|-------------|
| Auto Session Name | Names sessions from the first user message — no more unnamed-session-1 |
| Compact Header | Clean table-style startup header with keybinding reference |
| Clipboard Image | Paste base64 image data (PNG/JPEG) directly into the prompt |
| Image Context Pruner | Strips images from older messages to save context tokens |
| Markdown Viewer | Rendered markdown preview on Ctrl+O for .md files, plus /mdview and /mermaid commands |
| Screenshot | /ss command — grab clipboard image or send a file to the agent. Requires kitty terminal + kitten binary |
| Subagent | subagent and subagent_status tools for spawning background pi instances whose results auto-inject back |
Requirements
- pi 0.57+
- For screenshots: kitty terminal with
clipboard_control read-clipboard, tmux withallow-passthrough on,~/.local/bin/kitten - For mermaid rendering: internet access (uses mermaid.ink API)
License
MIT
