pi-model-banner

Provides a model specific banner for the pi.dev agent harness, displaying useful information like the model name, provider and thinking level.

Packages

Package details

extension

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

$ pi install npm:pi-model-banner
Package
pi-model-banner
Version
26.0.0
Published
Nov 9, 2026
Downloads
365/mo · 365/wk
Author
lennart-luttmann
License
MIT
Types
extension
Size
67.3 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-model-banner

A Pi extension that replaces the generic Pi header with a vendor- and model-specific banner, which includes:

  • The vendor's logo in its brand colors
  • Model name, vendor and provider
  • Every thinking level of the model, highlighting the selected one

The banner updates live when you switch models or thinking levels. On narrow terminals the logo steps aside and the details stay.

Install

pi install npm:pi-model-banner      # Install.
pi -e npm:pi-model-banner           # Try without installing.
pi remove npm:pi-model-banner       # Uninstall.

From git: pi install git:github.com/lennart-luttmann/pi-model-banner.

Thinking levels

For reasoning models the banner lists every thinking level the model supports and marks the active one. It also shows the hotkey used for cycling between them, if it exists.

Thinking: [off]· minimal · low · medium · high · xhigh · max  (shift+tab)
Thinking:  off · minimal · low ·[medium]· high · xhigh · max  (shift+tab)
Thinking:  off · minimal · low · medium · high · xhigh ·[max] (shift+tab)

If the selected model does not support different reasoning levels, this line is omitted.

Configuration

The default configuration should cover most providers and vendors. If your specific provider/vendor combination does not work properly or simply shows the default Pi logo, create or edit ~/.pi/agent/model-banner.json:

{
    "enabled": true,
    "overrides": {
        "<provider>/<model>": "<family id>"
    }
}
  • enabled — set to false to keep Pi's own header.
  • overrides — pick the logo for a model yourself. Map a model id, or provider/model, to a family id from Vendors.

Changes apply on the next start or after /reload. A mistake in the file never stops Pi from starting. The banner warns about it and skips what it cannot use.

Commands

Command Effect
/banner Toggle between Pi's default header and the model banner.
/banner on / /banner off Explicitly turn the banner on or off.
/banner status Show whether the banner is on, which logo it uses and the path of the config file it uses.

Troubleshooting

Symptom Fix
Boxes instead of dots Your terminal font does not include Unicode Braille characters.
Colors look off Your terminal has no 24-bit color support, so the brand colors are approximated.
No logo at all Use /banner status to check whether the banner is enabled and /banner on to enable it. If that does not work, your terminal could be too narrow. Try growing your terminal emulator window or decreasing your font size.

Should other errors occur or these troubleshooting steps fail, feel free to open a GitHub issue.

Versioning

The first number of a version is the year: 26.x.x releases come out in 2026, and 27.0.0 will be the first release of 2027. The second number counts feature releases, the third bugfixes. See CHANGELOG.md for what changed.

Working on the extension itself? See CONTRIBUTING.md.

Trademarks

Logos are trademarks of their respective owners; this project is not affiliated with or endorsed by any of them. Sources and licenses are listed in NOTICE.md.

Vendors

Vendors are normally inferred from the id of the model in use, regardless of provider. The provider is only used if the model id doesn't point at a recognized vendor. The following list includes all covered vendors and the keywords they are recognized by.

Your vendor of choice isn't covered? Feel free to open an issue or a pull request with your own implementation. For more information read CONTRIBUTING.md.

Anthropic

  • Models: Claude
  • Recognized by: claude
  • Providers: anthropic, claude
  • Family id: anthropic

OpenAI

  • Models: GPT, o-series, Codex
  • Recognized by: gpt, codex, chatgpt, o1…o9
  • Providers: openai, azure
  • Family id: openai

Google

  • Models: Gemini, Gemma
  • Recognized by: gemini, gemma
  • Providers: google, vertex, gemini
  • Family id: google

Mistral

  • Models: Mistral, Codestral, Devstral, Magistral
  • Recognized by: mistral, codestral, devstral, magistral
  • Providers: mistral
  • Family id: mistral

xAI

  • Models: Grok
  • Recognized by: grok
  • Providers: xai, x-ai
  • Family id: xai

No screenshot available

DeepSeek

  • Models: DeepSeek
  • Recognized by: deepseek
  • Providers: deepseek
  • Family id: deepseek

Qwen

  • Models: Qwen
  • Recognized by: qwen
  • Providers: qwen, dashscope, alibaba
  • Family id: qwen

Moonshot

  • Models: Kimi
  • Recognized by: kimi, moonshot
  • Providers: moonshot, kimi
  • Family id: moonshot

Z.ai

  • Models: GLM
  • Recognized by: glm
  • Providers: zai, z-ai, zhipu
  • Family id: zai

MiniMax

  • Models: MiniMax
  • Recognized by: minimax
  • Providers: minimax
  • Family id: minimax

Meta

  • Models: Llama
  • Recognized by: llama
  • Providers: meta, llama
  • Family id: meta

Fallback: Pi logo

  • Models: everything not listed above
  • Vendor shown as: Unknown
  • Family id: default

This project was developed and tested on Pi 1.5.0.