@siddr/pi-status

Status widget extension for pi

Package details

extension

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

$ pi install npm:@siddr/pi-status
Package
@siddr/pi-status
Version
0.1.6
Published
Apr 24, 2026
Downloads
453/mo · 137/wk
Author
siddr
License
MIT
Types
extension
Size
50 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

Status extension

Shows a status widget below the input editor with session context (plus an optional PR line):

  • Current provider/model
  • Current thinking level
  • Current OpenAI fast/verbosity indicators from openai-params when non-default, shown inside the thinking parentheses (/fast, 🗣️low, 🗣️medium, 🗣️high)
  • Current working directory
  • Current Git branch
  • Context usage percent plus used token count
  • Current/last agent time plus cumulative turn total and session time (<agent> agent · <turn total> turn total · <session> session)
  • Current GitHub PR URL for the active branch (includes (merged) / (closed) when not open)

Time values use a compact d/h/m format (XdYhZm, YhZm, or Zm) and are separated with a center dot (·). Agent time reflects the current or last completed prompt run. Turn total accumulates time spent across turns in the current session. All timers reset when a new session starts. The default footer widget is hidden while this extension is active.

Install

pi install npm:@siddr/pi-status

Usage

The status widget updates automatically during session events.

If openai-params is installed, the widget also listens for its event-bus updates and shows the current non-default fast/verbosity settings inside the thinking-level parentheses for the active workspace.

PR detection requires GitHub CLI (gh) and valid auth (gh auth status). By default, the PR line is resolved only for github.com. You can allow additional GitHub Enterprise hosts with PI_STATUS_ALLOWED_GITHUB_HOSTS (comma-separated exact hostnames).

Toggle the behavior with /custom-status.

Tests

bun test status/tests/*.test.ts