packages / spences10-pi-observability
extension Observability

@spences10/pi-observability

Optional live event stream and local web dashboard for Pi agent sessions

No reviews yet

Install

$ pi install npm:@spences10/pi-observability

Installs from npm into ~/.pi/agent/. Add -l for project-local (.pi/). Manage with pi list / pi update / pi remove.

What this package can reach

Detected automatically from the source at version 0.0.23. This describes access, not safety — you decide whether it's appropriate for what the package claims to do.

  • ⚡
    Commands — Runs shell commands Spawns processes on your machine.
  • 📁
    Files — Reads files outside your project Touches paths beyond the working directory, such as your home folder.
  • 🌐
    Network — Talks to the internet Makes outbound network requests. Check the destinations are ones you expect.
  • 📡
    LLM traffic — Sees raw model API traffic Reads or replaces provider requests, headers or responses — including your prompts.
  • ▤
    UI — Draws its own interface Renders widgets, footers, dialogs or full-screen views.

What it actually did when run

observed

Loaded in a sandbox with no network, a read-only filesystem and a recording stand-in for pi's API. This is what it called — not what the source suggests it might.

Events subscribed after_provider_responseagent_endbefore_agent_startbefore_provider_headersbefore_provider_requestmessage_endmessage_startmodel_selectsession_compactsession_info_changedsession_shutdownsession_startsession_treetool_calltool_execution_endtool_execution_starttool_execution_updatetool_resultturn_endturn_start

APIs called getFlagregisterCommandregisterFlagui.notify

15 calls the source scan did not predict

on("after_provider_response") · on("agent_end") · on("before_agent_start") · on("before_provider_request") · on("message_end") · on("message_start") · on("session_compact") · on("session_tree") · on("tool_call") · on("tool_execution_end") · on("tool_execution_start") · on("tool_execution_update") · on("tool_result") · on("turn_end") · on("turn_start")

Reached through a value the scan could not follow — passed as an argument, stored on another object, or returned by a helper.

Run against version 0.0.23 on 2026-08-02. Registration-time behaviour under default settings; other configurations may differ.

▲ Review before you install. pi packages run with your full system permissions. Check the source, pin versions, and prefer authors you trust.

Reviews

0 published

Sign in with GitHub to write a review, reply, or vote.

No reviews yet — be the first.

More in Observability