pi-tracer

ProObservabilityFSL-1.1-ALv2

Captures every byte that crosses the wire between Pi and your LLM provider - raw HTTP headers, request body, and the literal SSE stream. One artifact set per LLM call, written under your home directory.

Capabilities

Three files per call: request (URL, method, headers, body), response (status, headers, raw body or SSE lines), and metadata (usage, timing, stop reason).
API keys redacted before being written to disk.
Enabled by default - toggle per session or persist in config.
Artifacts live under ~/.pi/agent/pi-tracer/, outside any project repo - no .gitignore needed.

Tracer demo showing data interception and observability.

Installation Instructions

Install the whole bundle

npx --yes @bastilleworks/bastille-install bastilleworks-pro-<version>.tgz

Or install this module only

npx --yes @bastilleworks/bastille-install bastilleworks-pi-tracer-<version>.tgz

The installer fetches @bastilleworks/shared from public npm automatically. Replace <version> with the version you downloaded.

Usage Instructions

Pi command

/trace-toggle

Persist via ~/.pi/agent/extensions/pi-tracer.json with { "enabled": false } - takes effect on the next Pi session. /trace-toggle affects only the current session. Inspect artifacts with jq.

Uninstall

Uninstall this extension

pi uninstall npm:@bastilleworks/pi-tracer

Or uninstall the entire bundle

npx --yes @bastilleworks/bastille-install uninstall bastilleworks-pro-<version>.tgz

Notes

To disable header redaction for auth debugging, set redact_headers: false in the config.
Requires a valid Polar license.

All modules