packages / braintrust-pi-extension
extension

@braintrust/pi-extension

Braintrust observability for pi — automatic tracing for sessions, turns and LLM calls.

No reviews yet

Install

$ pi install npm:@braintrust/pi-extension

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.10.0. This describes access, not safety — you decide whether it's appropriate for what the package claims to do.

  • 🤖
    Behavior — Changes how the agent thinks Modifies the system prompt, injects messages, or rewrites conversation context.
  • Commands — Runs shell commands Spawns processes on your machine.
  • 🔑
    Credentials — Handles your API keys Reads or passes provider credentials. Highest-trust capability there is.
  • 📁
    Files — Reads files outside your project Touches paths beyond the working directory, such as your home folder.
  • Intercepts tools — Can block or rewrite tool calls Subscribes to tool_call/tool_result/input. Can change a command after you approved the one displayed.
  • 📡
    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_requestcontextinputmessage_endmessage_updatesession_before_compactsession_before_treesession_compactsession_shutdownsession_startsession_treethinking_level_selecttool_execution_endtool_execution_start

APIs called ui.setStatusui.setWidget

Run against version 0.10.0 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

  • pi-mcp-adapter — MCP (Model Context Protocol) adapter for pi — connect any MCP server's tools to your agent…
  • pi-telegram — Telegram DM bridge for pi — talk to your agent from your phone, by the author of pi itself…
  • @pi-stef/atlassian — Verified Atlassian Jira and Confluence tools for pi, as an extension and CLI.
  • @raindrop-ai/pi-agent — Raindrop observability for pi — automatic tracing via subscriber integration.