Pi Supervisor

pi-supervisor

A [pi](https://pi.dev) extension that supervises the coding agent and steers it toward a defined outcome. It observes every conversation turn, injects guiding messages when the agent drifts, and signals when the goal is reached — like a tech lead watching over a dev's shoulder.

A supervisor as the intelligent overseer keeping the agent on track.

**Status:** Early release.

https://github.com/user-attachments/assets/f3b23662-6473-4ac3-82f7-c7f9b64fa7c7

How It Works

/supervise Implement a secure JWT auth system with refresh tokens and full test coverage

Then start the conversation normally — the supervisor watches from outside without modifying the agent's context.

1. After each run — a separate supervisor LLM analyzes the conversation against the goal (all sensitivities)
2. Mid-run, between tool calls — also checks for drift on medium and high sensitivity and can steer the agent without waiting for it to finish
3. On completion — supervisor signals done and stops automatically

The supervisor is a pure outside observer. It runs in a separate in-memory pi session sharing only the API credentials and never touches the main agent's context window or system prompt.

Install

pi install npm:pi-supervisor

Or load directly for development:

pi -e ~/projects/pi-supervisor/src/index.ts

Commands

Command	Description
/supervise	Start supervising toward a desired outcome
/supervise or /supervise settings	Open the interactive settings panel
/supervise stop	Stop active supervision
/supervise status	Show current state (opens settings panel if active)
/supervise widget	Toggle the status widget on/off
/supervise model	Open the interactive model picker
/supervise model	Set supervisor mo