@samfp/pi-essentials

Essential extensions for pi — auto session naming, compact header, clipboard images, image pruning, markdown viewer, screenshots, and subagents.

Package details

← Back

extension

Install @samfp/pi-essentials from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@samfp/pi-essentials

Package: @samfp/pi-essentials
Version: 0.2.3
Published: Apr 23, 2026
Downloads: 589/mo · 181/wk
Author: samfp
License: MIT
Types: extension
Size: 65.9 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./src/auto-session-name.ts",
    "./src/auto-title.ts",
    "./src/compact-header.ts",
    "./src/clipboard-image.ts",
    "./src/image-context-pruner.ts",
    "./src/markdown-viewer.ts",
    "./src/screenshot.ts",
    "./src/subagent.ts",
    "./src/context-pruner.ts",
    "./src/daily-log.ts"
  ]
}

Security note

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

README

pi-essentials

Essential extensions for pi — quality-of-life improvements that every setup should have.

Install

pi install npm:@samfp/pi-essentials

What'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
Context Pruner	`context_prune` tool — lets the agent replace bulky search results with short summaries to free context space
Daily Log	`daily_log` tool — append timestamped entries to a daily markdown note (configurable via env vars)
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 with allow-passthrough on, ~/.local/bin/kitten
For mermaid rendering: internet access (uses mermaid.ink API)

License

MIT