@wienerberliner/pi-footer

Custom pi footer panels for git status and current agent context tokens.

Package details

extension

Install @wienerberliner/pi-footer from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@wienerberliner/pi-footer

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ],
  "image": "https://raw.githubusercontent.com/dasomji/pi-footer/main/assets/pi-footer-wide.png"
}

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

A small pi extension that replaces the built-in footer with responsive panels:

GIT — worktree, branch, optional upstream, ahead/behind counts; outside a repository it shows the working directory and no git initialised
AGENT — estimated current context tokens as a number, context window size, active model/thinking level, plus Fast when pi-codex-fast is active for the selected model
STATUS — extension-provided footer statuses from Pi's status API, such as postbox connected/disconnected state

The panel layout is inspired by @alasano/pi-panels, but this package intentionally has no settings command and no Spotify panel.

Captured from real Pi TUI ANSI output, desktop-width terminals show the panels side by side:

pi-footer desktop layout

Narrow terminals are mobile-ready: when there is not enough horizontal space, the panels stack vertically instead of overflowing.

pi-footer stacked mobile layout

From npm:

pi install npm:@wienerberliner/pi-footer

Or directly from GitHub:

pi install git:github.com/dasomji/pi-footer

Then restart pi or run /reload.

Auto-enables on session start in interactive UI mode.
Refreshes git state every 5 seconds and after each agent turn.
Updates agent token/model/Fast Mode info after turns and model/thinking changes.
Shows any extension statuses published through Pi's footer status API, while avoiding duplicate Fast Mode status.
Restores pi's default footer when the session shuts down or extensions reload.

MIT