pi-tldr

A pi coding-agent extension that shows live TLDR summaries above the input bar.

Package details

← Back
extension

Install pi-tldr from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-tldr
Package
pi-tldr
Version
0.1.1
Published
May 3, 2026
Downloads
85/mo · 85/wk
Author
richietan
License
MIT
Types
extension
Size
30.3 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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.

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