@ricoyudog/pi-debug-dashboard

Real-time debug dashboard for the pi coding agent — browser-based session visualization with SSE

Packages

Package details

extension

Install @ricoyudog/pi-debug-dashboard from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@ricoyudog/pi-debug-dashboard
Package
@ricoyudog/pi-debug-dashboard
Version
0.1.0
Published
Jun 3, 2026
Downloads
not available
Author
ricoyudog
License
MIT
Types
extension
Size
86.4 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "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-debug-dashboard

Real-time browser-based debug dashboard for the pi coding agent. Visualize agent sessions with SSE streaming, Gantt timelines, context gauges, compaction logs, and more.

Installation and Usage

Extension Mode (inside pi)

Install via pi's package manager, then start the dashboard from within a pi session:

pi install npm:@ricoyudog/pi-debug-dashboard

After installation, use the /dashboard start command in pi. Open http://localhost:9848 in your browser.

Standalone Mode (CLI)

Clone the repository and run the standalone server against a pi debug log:

git clone https://github.com/ricoyudog/pi-debug-dashboard.git
cd pi-debug-dashboard
npx tsx src/standalone.ts --log <path> [--port 9848]

Requires tsx (npm install -g tsx). Open http://localhost:9848 in your browser.

Features

  • Session browsing with enriched labels (CWD, session name, goal, first message)
  • Real-time SSE streaming of agent events
  • Gantt timeline showing tool execution duration and errors
  • Context gauge showing token usage as percentage of context window
  • System prompt panel and startup info display
  • Compaction log tracking
  • Full-text search and filtering
  • Keyboard navigation
  • Light/dark theme toggle

Development

git clone https://github.com/ricoyudog/pi-debug-dashboard.git
cd pi-debug-dashboard
npm install

Standalone dev: Run against your pi debug log:

npx tsx src/standalone.ts --log ~/.pi/agent/pi-debug.log

Extension mode dev: Install locally for testing inside pi:

pi install npm:@ricoyudog/pi-debug-dashboard

License

MIT. See LICENSE.

GitHub: ricoyudog/pi-debug-dashboard