@pi-vault/pi-status

Pi extension that replaces the default status with a Codex-like status

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@pi-vault/pi-status
Package
@pi-vault/pi-status
Version
0.2.1
Published
Jun 15, 2026
Downloads
330/mo · 179/wk
Author
lanhhoang
License
MIT
Types
extension
Size
634.3 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@pi-vault/pi-status

npm version Quality Node >= 22.19 License: MIT

Replace Pi's default footer with a compact status line that shows the session details you actually care about. The extension installs a live footer and adds /statusline, an interactive editor for choosing, ordering, and previewing footer segments.

Default footer:

model-with-reasoning · current-dir

Screenshots

Default status line rendering:

Status line UI

Interactive configuration editor (/statusline):

Status line configuration

Install And Reload

Install the extension:

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

Optional: install pi-usage if you want the five-hour-limit and weekly-limit footer segments:

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

Reload Pi after installing or upgrading:

/reload

Use /statusline

Once installed, the footer updates automatically. Run /statusline inside Pi to open the interactive editor.

The editor lets you:

  • turn footer items on or off
  • reorder enabled items with Left and Right
  • search the segment list
  • preview the result before saving
  • control which extension status messages are shown

Changes are saved and reused the next time Pi starts.

During editing, the live footer is temporarily hidden so the inline UI can use the full width cleanly.

Available Footer Items

You can compose the footer from these segment IDs:

  • 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 depend on standalone @pi-vault/pi-usage. When pi-usage is not installed or has not responded yet, those segments are hidden from /statusline and omitted from the footer.

extension-statuses renders the visible extension status values reported by Pi extensions. /statusline also lets you hide individual status keys or switch to an allowlist.

Common Examples

Keep it minimal:

model-with-reasoning · current-dir

Show more session detail:

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

Usage-aware footer:

model-with-reasoning · current-dir · five-hour-limit · weekly-limit

Show extension activity too:

model · current-dir · extension-statuses

Compatibility

  • Node.js >=22.19
  • 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.79.3 and @earendil-works/pi-tui@0.79.3

Development

pnpm install
pnpm check
pnpm run pack:dry-run

License

MIT