@pi-vault/pi-status

Replace Pi's default footer with a cleaner Codex-style status line that stays out of the way but keeps the useful bits visible.

Default status line:

model-with-reasoning · current-dir

Status: Early-adopter release (v0.1.0). It is ready to use, but the available segments and configuration details may still change before v1.0.

Install

pi install npm:@pi-vault/pi-status

Then reload Pi:

/reload

Use

Once installed, the footer updates automatically.

Use /statusline inside Pi to:

• turn footer items on or off
• reorder the items you want to see
• preview the result before saving
• control which extension status messages are shown

Changes are saved and reused the next time Pi starts.

Available Status Items

You can build your footer from these items:

• model
• model-with-reasoning
• project-name
• current-dir
• git-branch
• run-state
• context-remaining
• context-used
• context-window-size
• used-tokens
• total-input-tokens
• total-output-tokens
• session-id
• five-hour-limit
• weekly-limit
• extension-statuses

five-hour-limit and weekly-limit come from @pi-vault/pi-usage and only appear when that usage data is available.

Common Setups

Keep it minimal:

model-with-reasoning · current-dir

Show more session detail:

model · run-state · git-branch · context-used · context-remaining · session-id

Compatibility

• Node.js >=22.12
• Pi host environment with @earendil-works/pi-coding-agent and @earendil-works/pi-tui
• Tested in this repo against @earendil-works/pi-coding-agent@0.78.x and @earendil-works/pi-tui@0.78.x

Development Setup

pnpm install
pnpm check
pnpm pack --dry-run
pi -e .

License

MIT