pi-bar

Never accidentally run Opus on a typo again. pi-bar keeps your model, thinking level, context pressure, a live progress update, and any extension statuses visible in pi's footer.

claude-opus-4.7  ❯  think:med  ❯  2.6% / 1.0M  ❯  Reviewing package structure  ❯  plan:active ❯ queue:2

Why use it?

• See the active model at a glance — catch accidental model switches before an expensive or sensitive task starts.
• Track thinking level in place — immediately notice when you are using the wrong reasoning setting.
• Watch context pressure early — context usage turns green, yellow, then red as you approach the limit.
• Follow what pi is doing — a one-line progress update keeps the current task visible without scrolling.
• Keep extension statuses visible — statuses other extensions set still appear in the footer.

pi-bar is intentionally tiny: one small extension and no broad behavior changes. It replaces pi's built-in footer with a compact model / thinking / context / progress / extension-status line.

Install

pi install npm:pi-bar

If pi is already running after install, reload resources:

/reload

Customization

pi-bar works out of the box. Run /bar inside pi to choose which footer segments and extension statuses are shown:

/bar

Toggle Model, Thinking level, Context usage, Progress update, and Extension statuses between shown and hidden. If other extensions have published status badges, /bar also shows fine-grained Status: <key> rows plus a New extension statuses default. You can also use commands:

/bar segments list
/bar segments only model context
/bar segments hide progress
/bar segments show thinking

Allowed segments are model, thinking, context, progress, and extensions. The progress segment stays hidden until pi-bar has a current update. The extensions segment stays hidden when no extension has set a status.

You can also set startup defaults with environment variables before launching pi:

PI_BAR_SHOW=model,thinking,context,progress,extensions pi
PI_BAR_SHOW=model,context pi

Configure live progress updates

pi-bar shows a short, plain-English description of what pi is working on right now. It refreshes as pi works and resets when you switch branches in the session tree, so stale updates never follow you across tasks. Hide Progress update in /bar, run /bar segments hide progress, or set PI_BAR_SHOW without progress to disable it.

Pick a specific model for the update by setting the env var or pi settings:

PI_BAR_PROGRESS_MODEL=anthropic/claude-haiku-4-5 pi

Or in pi settings: bar.progressModel. Otherwise pi-bar picks a fast model you are already authenticated with.

Configure extension statuses

Other pi extensions can publish small status badges. Pi-bar collects them into the extensions segment, strips embedded terminal colors, and separates each badge with the same ❯ divider used by other footer segments. Run /bar or /bar status inside pi to pick which ones to show:

/bar status

Toggle each status between shown and hidden. The New statuses row controls the default for badges that appear later.

Your choices persist across pi sessions in ~/.pi/agent/pi-bar.json. Override the path with PI_BAR_CONFIG=/some/path.json.

Change context thresholds

PI_BAR_THRESHOLDS=60,85 pi

The first number is the warning/yellow threshold. The second number is the danger/red threshold. Defaults are 70,90.

Pairs well with

• pi-chrome — give your Pi agent your real, signed-in Chrome. Use pi-bar's red-context threshold as the signal to wrap up long browser scrapes before context overflows.
• pi-qq — ask side questions about what the agent just did without polluting the transcript.

Security note

Pi extensions run with your local user permissions. Review any pi package source before installing it.

Progress updates send short snippets of your session activity to the selected model provider. Hide Progress update in /bar or disable the progress segment with PI_BAR_SHOW if that is not acceptable.