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

• Source code: https://github.com/MusherM/pi-prompt-view
• Issue tracker: https://github.com/MusherM/pi-prompt-view/issues