pi-peek

A pi extension for browsing current session scrollback in an overlay.

Package details

← Back

extension

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

npm repo home report

$ pi install npm:pi-peek

Package: pi-peek
Version: 0.1.2
Published: May 5, 2026
Downloads: not available
Author: yeshwanthyk
License: MIT
Types: extension
Size: 4.3 MB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ],
  "video": "https://raw.githubusercontent.com/Yeshwanthyk/pi-peek/main/media/demo.mp4",
  "image": "https://raw.githubusercontent.com/Yeshwanthyk/pi-peek/main/media/preview.png"
}

Security note

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

README

pi-peek

Peek is a pi extension for browsing the current session scrollback in a keyboard-driven overlay.

https://raw.githubusercontent.com/Yeshwanthyk/pi-peek/main/media/demo.mp4

Install

Recommended, via npm:

pi install npm:pi-peek

Or install from git:

pi install git:github.com/Yeshwanthyk/pi-peek

Pinned installs:

pi install npm:pi-peek@0.1.2
pi install git:github.com/Yeshwanthyk/pi-peek@v0.1.2

Project-local install:

pi install -l npm:pi-peek
pi install -l git:github.com/Yeshwanthyk/pi-peek

Try for one run without installing:

pi -e npm:pi-peek
pi -e git:github.com/Yeshwanthyk/pi-peek

After installing, run /reload in pi or restart pi.

Legacy manual install

git clone https://github.com/Yeshwanthyk/pi-peek ~/.pi/agent/extensions/peek

Use

Ctrl+Shift+J: open Peek
/peek: open Peek
j / k: scroll down/up
J / K: jump next/previous message
g / G: top/bottom
t: toggle tool messages
/, n, N: search
M: copy current message
o: view current message in nvim
O: edit current assistant message in nvim
q / Esc: close

Package metadata

This repo is a pi package. package.json declares:

{
  "keywords": ["pi-package"],
  "pi": {
    "extensions": ["./index.ts"],
    "video": "https://raw.githubusercontent.com/Yeshwanthyk/pi-peek/main/media/demo.mp4",
    "image": "https://raw.githubusercontent.com/Yeshwanthyk/pi-peek/main/media/preview.png"
  }
}

That lets users install it with pi install npm:pi-peek or pi install git:github.com/Yeshwanthyk/pi-peek instead of manually copying files into ~/.pi/agent/extensions.

Security

Pi packages run with your local user permissions. Review third-party extensions before installing them.