@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.1.0
Published
Jun 2, 2026
Downloads
not available
Author
lanhhoang
License
MIT
Types
extension
Size
49.3 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts",
    "node_modules/@pi-vault/pi-usage/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.12 License: MIT

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