pi-context-view

Pi extension to visualize context usage and inspect the hidden parts: base prompt, tools defs, and extension injections

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-context-view
Package
pi-context-view
Version
0.7.2
Published
Oct 17, 2026
Downloads
9,301/mo · 2,424/wk
Author
dimk90
License
MIT
Types
extension
Size
507.7 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "image": "https://media.githubusercontent.com/media/dimk90/pi-context-view/9a9f9f4fafaa09c77759485d53c42f8694650755/doc/images/pi-context-view.png",
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-context-view

Pi extension that visualizes context usage and lets you inspect the parts you normally can't see: the system prompt, tool definitions, and instructions injected by other extensions.

Features

  • Context usage map - visualize used and free context space, grouped by category (tools, skills, messages, and more).

  • Context injections - explore the hidden parts of the context: the system prompt, tool definitions, and extension injections, including changes that extensions make only to the request sent to the model.

Commands

  • /context - shorthand for /context usage.
  • /context usage - open the context usage visualization.
  • /context injections - explore the latest request's injections: its system prompt, tool definitions, and extension contributions.
  • /context config - create the global configuration file populated with defaults, useful for customization.

Demo

/context

See what fills your context, for example, what survives compaction:

Context usage view showing estimated context composition

/context injections

Inspect hidden parts of the context, such as tool definitions:

Context injections view and item preview

Zoom

Zoom in for a more detailed breakdown of large context windows, such as 1M-token windows:

Zoom feature

Install

pi install npm:pi-context-view

Customization

Currently, you can customize only the colors and dimensions of the Context Usage map.

To get started, create a configuration file populated with the current defaults:

/context config

This creates ~/.pi/agent/extensions/pi-context-view.json.

See the configuration reference for each parameter's meaning and default value.

Category Colors

You can use theme color names to match your current theme or hex values for colors that stay the same across themes. Here are examples of custom terrain and rainbow palettes:

Terrain and rainbow palettes

See the theme color reference for color names that follow the current theme.

Map Size

You can configure the number of rows and columns in the Context Usage map:

Map size demo

Context Footprint

pi-context-view adds nothing to the model context. Opening a view before the first turn may run one silent probe that sends no request and leaves only blank entries, omitted from future context. Set "autoProbing": false in the config to disable it.

My Other Stuff

📌 S-VHS - terminal recorder used to create the demo GIFs.

License

MIT