pi-session-inspector

Branch-aware, bounded Pi session inspection tool

Packages

Package details

extension

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

npm report
$ pi install npm:pi-session-inspector
Package
pi-session-inspector
Version
0.1.0
Published
Sep 12, 2026
Downloads
173/mo · 11/wk
Author
boadij
License
unknown
Types
extension
Size
45.4 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/session-inspector.ts"
  ]
}

Security note

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

README

Pi Session Inspector

pi-session-inspector adds one model-callable Pi extension tool, session_inspect, for bounded, branch-aware inspection of the active session or an explicitly supplied historical .jsonl session.

Install

pi install /absolute/path/to/pi-session-inspector

Reload Pi after installing.

Tests

With Pi 0.85.1 installed and available as pi, run the regression suite through Pi's bundled extension loader:

bun run test

The test command does not install or bundle Pi's peer packages.

Actions

session_inspect supports:

  • summary - session metadata, message/tool counts, errors, token/cost usage, compactions, leaves
  • timeline - bounded compact entry timeline
  • tools - correlated tool calls/results with status
  • errors - tool and assistant errors
  • search - case-insensitive targeted session search
  • branches - leaf/branch overview
  • entry - exact bounded entry inspection

Scopes:

  • branch - current active path, default
  • all - entire session tree
  • context - active branch after Pi's context/compaction rules

By default the tool inspects the active session. session may point explicitly to another Pi .jsonl session file; historical files are parsed and migrated in memory and are never rewritten.

Typical agent workflow

session_inspect(action="summary")
session_inspect(action="errors", limit=10)
session_inspect(action="search", query="src/auth.ts", limit=10)
session_inspect(action="entry", entryId="...")

The tool excludes its own session_inspect calls from tool-call statistics and its tool results from tool-result statistics; the assistant messages and usage that produced them remain normal session data. Output is bounded, redacted, and omits thinking blocks and image payloads.