@d3ara1n/pi-peek-user

Local /peek overlay for pi — ask your own session a question without disturbing the main agent (read-after-burn)

Packages

Package details

extension

Install @d3ara1n/pi-peek-user from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@d3ara1n/pi-peek-user

Package: @d3ara1n/pi-peek-user
Version: 0.7.0
Published: Sep 10, 2026
Downloads: 321/mo · 8/wk
Author: d3ara1n
License: MIT
Types: extension
Size: 1,013.6 KB
Dependencies: 2 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "image": "https://raw.githubusercontent.com/d3ara1n/pi-extensions/main/packages/pi-peek-user/preview.png"
}

Security note

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

README

@d3ara1n/pi-peek-user

/peek overlay for pi — ask your own session a question without disturbing the main agent.

Opens a centered overlay that serializes the current conversation and streams an answer from the utility model (read-after-burn). The main agent keeps running, completely unaware.

╭──────────────────────────────────────────────────╮
│ peek (main agent: idle, turn 3)                  │
├──────────────────────────────────────────────────┤
│ you                                              │
│ how is the debounce implemented?                 │
│ peek                                             │
│ debounce uses requestAnimationFrame, cancelled   │
│ in the useEffect cleanup…                        │
├──────────────────────────────────────────────────┤
│ ▮                                                │
├──────────────────────────────────────────────────┤
│ model deepseek/deepseek-v4-flash   tokens 1.2k   │
├──────────────────────────────────────────────────┤
│ Esc · ↑↓ scroll · PageUp/Dn jump · Enter         │
╰──────────────────────────────────────────────────╯

Features

Streaming Markdown — the answer appears token-by-token with pi's native Markdown rendering and syntax highlighting
Auto-height — the message region grows with content up to ~80% of the terminal, then scrolls (↑/↓, auto-follows the tail while streaming)
Message navigation — prominent turn dividers and PageUp/PageDown jumps across the full local history (Fn+↑/Fn+↓ on MacBook)
Multi-turn — follow-up questions reuse the serialized context (cheaper, no re-serialization)
Live status — header shows what the main agent is doing right now; status line shows the utility model + cumulative tokens
Read-after-burn — closing the overlay discards everything; the main session is never touched
Command palette entry — "Peek: Ask This Session" runs directly from the palette, mid-draft

Installation

pi install npm:@d3ara1n/pi-model-roles
pi install npm:@d3ara1n/pi-peek
pi install npm:@d3ara1n/pi-peek-user

Or add to ~/.pi/agent/settings.json:

{
  "extensions": [
    "/absolute/path/to/pi-extensions/packages/pi-model-roles",
    "/absolute/path/to/pi-extensions/packages/pi-peek",
    "/absolute/path/to/pi-extensions/packages/pi-peek-user"
  ]
}

Dependencies

@d3ara1n/pi-peek — consult core (tracker hooks + investigate backend)
@d3ara1n/pi-command-palette-core — native command-palette registry (pure npm library, installed automatically; entries appear when pi-command-palette is installed)

Usage

/peek

Or pick Peek: Ask This Session in the command palette (Ctrl+Shift+P, via pi-command-palette) — it opens the same overlay directly, without needing an empty editor.

Type a question, press Enter. The answer streams in. Ask follow-ups, use PageUp/PageDown to jump between your questions (Fn+↑/Fn+↓ on MacBook), or press Esc to close.

License

MIT