pi-tldr

A pi extension that shows a small live tldr box above the input bar while the agent works.

It summarizes what pi is currently doing and keeps a final result summary visible until the next prompt starts.

Install

Install globally for all pi projects:

pi install npm:pi-tldr

Then restart pi, or run this inside an active pi session:

/reload

Try it for one run without adding it to your settings:

pi -e npm:pi-tldr

Remove it:

pi remove npm:pi-tldr

Requirements

• A recent version of pi with package/extension support.
• At least one configured API key for a supported TLDR model.

Supported TLDR models

Only these confirmed-working models are supported for TLDR generation and direct selection:

1. anthropic/claude-haiku-4-5
2. anthropic/claude-haiku-4-5-20251001
3. openai-codex/gpt-5.4-mini
4. openai-codex/gpt-5.3-codex-spark

auto tries the supported models in this order. If none has a configured API key, the extension stays quiet instead of showing fake fallback text.

Choose a TLDR model

Prefer a specific model when starting pi:

pi --tldr-model anthropic/claude-haiku-4-5

Or choose from pi's searchable model selector UI:

/tldr-model

The selector includes auto plus the supported TLDR models available with your configured API keys.

Set a model directly:

/tldr-model anthropic/claude-haiku-4-5

Use automatic model selection:

/tldr-model auto

Reset also returns to automatic model selection and removes the saved preference:

/tldr-model reset

The selected model is saved across sessions in an extension-owned config file:

~/.pi/agent/pi-tldr.json

If PI_CODING_AGENT_DIR is set, the file is saved there instead.

Precedence:

1. --tldr-model for the current pi run
2. saved pi-tldr.json preference
3. auto, which uses the supported model list above

If the selected model is unavailable, pi-tldr falls back to auto. /tldr-model reset removes the saved preference.

Privacy

pi-tldr sends short snippets from recent prompt, assistant, tool, and result activity to the selected TLDR model provider. This activity is generally already part of the pi agent context, but auto may send it to an additional or different provider from your main pi model.

pi-tldr does not attempt to detect or redact secrets. It disables prompt caching for TLDR requests and keeps snippets short, but this is not a security boundary. Do not use pi-tldr where sending these snippets to the TLDR provider is unacceptable.

What it does

During a prompt, pi displays a compact box like:

╭ tldr ─────────────────────────────────────────────╮
│ Inspecting the extension package structure        │
╰───────────────────────────────────────────────────╯

The TLDR updates as pi works, including during tool calls and final responses.

License

MIT