@hheei/pi-debug

Development diagnostics and TUI replay tools for Pi extensions.

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@hheei/pi-debug

Package: @hheei/pi-debug
Version: 0.2.0
Published: Oct 4, 2026
Downloads: 456/mo · 15/wk
Author: hheei
License: MIT
Types: extension
Size: 93.7 KB
Dependencies: 3 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "src/extension.ts"
  ]
}

Security note

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

README

@hheei/pi-debug

Development diagnostics, prompt cache analysis, and TUI replay tools for Pi extensions.

pi install npm:@hheei/pi-debug

Features

Prompt cache debugger

Hash-only provider payload diagnostics correlated with cacheRead and cacheWrite. The Pi extension exposes /cache-debug and records structured JSONL traces without storing sensitive prompt or response text.

Command: /cache-debug in Pi TUI mode.
See the Cache Debugging Guide for detailed trace interpretation.

Deterministic TUI Replay

Headless component replay with input, keystrokes, resize events, artificial wait timers, and optional real-model responses. Captures clean ANSI terminal frames and exports plain text, ANSI, SVG, or metadata artifacts for documentation and snapshot testing.

See the TUI Replay Guide for replay scripting and CLI parameters.

Package entry points

@hheei/pi-debug                 Pi extension and cache probe API
@hheei/pi-debug/tui-replay      Deterministic TUI replay library
pi-tui-replay                   Automatic replay and shell snapshot CLI
replay                          Incremental action-journal CLI

Development

pnpm test -- packages/pi-debug/test
pnpm run test:integration
pnpm run typecheck