Skip to main content
pi is a terminal-based coding agent. It has the deepest Opper integration of any agent here: a first-party provider package that adds the full catalog, automatic session span tracing, and seven multimodal tools.

Setup

One command, no config files:
This adds an opper provider entry to ~/.pi/agent/models.json — idempotently, alongside any existing providers — and starts pi.

Native provider package

For the full integration, install @opperai/pi-provider:
This gives you three things the plain provider block doesn’t:
  • The whole catalog in the /model picker, not a hand-listed subset.
  • Automatic session span tracing — once you turn tracing on, every turn in a pi session lands under one trace in Opper.
  • Seven multimodal tools registered directly in pi: image generation, image analysis, text-to-speech, speech-to-text, web search, web fetch, and embeddings.

Load only the provider or only the tools

Both halves load by default. To take one, name the extensions explicitly in ~/.pi/agent/config.json:
Drop either entry from extensions to load just the other half.

Choosing a model

Use /model inside a session. With the provider package installed, the picker lists the full catalog.

Environment variables

Traces

Session spans from pi, grouped per conversation once tracing is on.

All integrations

Every app that runs on Opper.
Last modified on October 2, 2026