pi-prompt-view

Local, read-only prompt provenance inspector for Pi Coding Agent

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-prompt-view
Package
pi-prompt-view
Version
1.0.0
Published
Aug 7, 2026
Downloads
427/mo · 427/wk
Author
musherm
License
MIT
Types
extension
Size
36.9 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/index.ts"
  ]
}

Security note

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

README

pi-prompt-view

中文

A local, read-only prompt source inspector for the Pi Coding Agent.

It displays:

  • the system prompt assembled by Pi;
  • sources such as SYSTEM.md, appended prompts, AGENTS.md, skills, tools, and user input;
  • active session entries and context messages after compaction;
  • the provider-specific payload at the before_provider_request hook.

All content is collapsed by default. The extension does not modify prompts, messages, or provider payloads, nor does it write captured content to disk or send it over the network.

Installation

For local development:

npm install
pi -e ./extensions/index.ts

As a Pi package:

pi install npm:pi-prompt-view

From a local directory:

pi install /absolute/path/to/pi-prompt-view

Usage

  • Enter /prompt-view
  • Or press Ctrl+Shift+P

Keyboard controls:

Key Action
↑ / ↓, n / p Move the selection
Enter / Space Expand or collapse the selected item
j / k Scroll expanded long content one line at a time; move the selection when the content is shorter
Ctrl+D / Ctrl+U Scroll down/up half a page
g / G Jump to the beginning/end of the expanded item
Tab / Shift+Tab Switch between Sources / Context / Request
/ Search
E Expand or collapse all content on the current page
Press R twice Temporarily reveal masked sensitive values
q / Esc Close

In non-TUI modes such as print, JSON, or RPC, the command displays only a summary without content bodies.

Accuracy Boundaries

before_provider_request runs after the provider payload has been constructed, but Pi invokes extension handlers in load order. If another extension modifies the payload after this extension, the view shows the payload captured when this extension's hook ran, not the final bytes sent over the network.

Source confidence uses the following labels:

  • ✓ exact: provided directly by Pi events, SessionManager, or sourceInfo;
  • ≈ derived: inferred from the current state, for example when an event has not yet fired;
  • ? residual: content exists but cannot be attributed reliably. The extension does not guess its source.

Development Verification

npm run verify

For the complete end-to-end verification covering a real Pi instance, an installed package, and a local mock provider:

npm run verify:all

Node.js 22.19 or later is required. The current development and end-to-end verification baseline is Pi 0.81.1.

Project Links