@e9n/pi-web-dashboard
v0.3.0
Published
Live agent dashboard for pi — SSE streaming, session view, and prompt submission
Readme
@e9n/pi-web-dashboard
Live agent dashboard with SSE streaming for pi — watch agent activity in real-time and submit prompts from the browser.
Features
- Live event stream — SSE feed of agent lifecycle events (start/end, turns, tool calls, responses)
- Prompt submission — send prompts to the agent from the browser (rate-limited: 10/min per IP)
- Slash command routing —
/commandsare dispatched via event bus (extensions), expanded from disk (skills/templates), or sent as literal text (unknown) - Command listing —
GET /api/dashboard/commandsreturns available slash commands for autocomplete - Auto-cleanup — closes all SSE connections on shutdown
- Requires pi-webserver — mounts automatically when pi-webserver is ready
Web UI
Mounts on pi-webserver at session start (listens for web:ready):
| Route | Method | Description |
|-------|--------|-------------|
| /dashboard | GET | Dashboard HTML (dashboard.html) |
| /api/dashboard/commands | GET | List available slash commands |
| /api/dashboard/events | GET | SSE event stream |
| /api/dashboard/prompt | POST | Submit a prompt — auto-routes /commands |
| /api/dashboard/stop | POST | Abort the running agent |
| /api/dashboard/config | GET | Status: SSE client count, server time |
SSE events
| Event type | Fields | Description |
|------------|--------|-------------|
| user_message | text, time | User submitted a prompt (non-command) |
| command_dispatched | command, args, time | Slash command routed (extension/skill/template) |
| connected | time | Initial connection handshake |
| agent_start | time | Agent loop started |
| agent_end | time | Agent loop finished |
| turn_start | turn | New turn began |
| turn_end | turn, text, toolResults | Turn completed with response text |
| tool_start | toolName, toolCallId | Tool execution started |
| tool_end | toolName, isError, preview | Tool execution finished (first 200 chars of output) |
Install
pi install npm:@e9n/pi-web-dashboardLicense
MIT
