@odinlayer/pi-statusbar

Footer / statusline extension for pi, by odinlayer. Shows model + effort, CWD, context usage, live token rate, and session cost.

Packages

Package details

extension

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

npm report

$ pi install npm:@odinlayer/pi-statusbar

Package: @odinlayer/pi-statusbar
Version: 0.3.3
Published: Jul 3, 2026
Downloads: 1,237/mo · 63/wk
Author: peixotorms
License: MIT
Types: extension
Size: 46.5 KB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/pi-statusbar.ts"
  ]
}

Security note

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

README

pi-statusbar

A footer / statusline extension for pi, by odinlayer.

Replaces pi's built-in footer with left-aligned segments:

<model> <effort> · <directory> · <pct>% of <window> used · TTFT <ttft>s · <tps> TPS · $<total>

Example:

deepseek-v4-pro-zen medium · ~/projects/foo · 9.2% of 1.0M used · TTFT 2.73s · 62 TPS · $3.70

Segments

Segment	Content
`directory`	Full CWD (with `~` for `$HOME`), middle-truncated
`model`	`<model-id> <effort>`, model id is colored, effort is full name (e.g. `medium`) and effort-colored
`context`	`<pct>% of <window> used`, turns yellow >75%, orange >85%, red >95%
`tokens`	`TTFT <ttft>s · <tps> TPS`, threshold-colored, TPS updates live during streaming
`cost`	`$<total>` session total in USD, gradient-colored (green→red)

Install

pi install npm:@odinlayer/pi-statusbar

Or deploy from this source tree:

cd /home/deploy/source
make deploy

The deploy target copies extensions/pi-statusbar.ts to the global pi extension directory (~/.pi/agent/extensions/pi-statusbar.ts) and removes any pi-footer-bar entry from settings.json.

Configuration

Run /statusbar inside pi to open the segment configurator, or use the subcommands:

/statusbar
/statusbar segments list
/statusbar segments all
/statusbar segments none
/statusbar segments only directory model
/statusbar segments show tokens
/statusbar segments hide tokens

The chosen set is persisted to ~/.pi/agent/pi-statusbar.json.

Environment overrides:

PI_STATUSBAR_SHOW — comma-separated list of segments to show.
PI_STATUSBAR_CONFIG — override the config file path.

License

MIT. See LICENSE.