pi-session-summary

A pi extension that dynamically maintains a one-line LLM-generated session summary, set as the session name so it appears in pi's status bar and /resume session list.

Model is auto-detected from available cheap models (gpt-5.4-nano, gpt-5.4-mini, gemini-3-flash, claude-4-5-haiku), or can be configured explicitly.

Install

pi install pi-session-summary

Or add to settings.json:

{
  "packages": ["pi-session-summary"]
}

Commands

| Command | Description | |---------|-------------| | /summary:settings | Creates the global settings JSON file (~/.pi/agent/session-summary.json) with defaults if it doesn't exist, and shows instructions to edit it. Run /reload after editing. | | /summary:update | Force an immediate summary update, bypassing the debounce timer. | | /summary:clear | Reset the summary to the first line of the first user message, clearing all accumulated state. | | /summary:cost | Show the summary model name, number of LLM calls, token usage, and cost breakdown for the current session. |

Configuration

Create ~/.pi/agent/session-summary.json (global) or .pi/session-summary.json (project override). Project settings are merged on top of global settings, which are merged on top of defaults. Config is reloaded on session start/switch and /reload.

All fields are optional — only specify what you want to override:

{
  "provider": "openai-codex",
  "model": "gpt-5.4-mini",
  "debounceSeconds": 60,
  "maxTokens": 300,
  "resummarizeTokenThreshold": 40000,
  "showWidget": false,
  "verbose": false
}

| Setting | Default | Description | |---------|---------|-------------| | provider | (auto-detect) | Model provider | | model | (auto-detect) | Model ID | | debounceSeconds | 60 | Min seconds between LLM calls | | maxTokens | 300 | Max tokens for LLM response | | resummarizeTokenThreshold | 40000 | Token threshold for full re-summarize vs incremental update | | showWidget | false | Show a belowEditor widget with summary, staleness, and compaction info | | verbose | false | Show a notification whenever the summary changes |