@alexeyco/pi-statusline

Compact footer for the pi coding agent — model/thinking and context usage on the left, MCP server count on the right, extension statuses below

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@alexeyco/pi-statusline

Package: @alexeyco/pi-statusline
Version: 0.2.0
Published: Oct 4, 2026
Downloads: 246/mo · 10/wk
Author: alexeyco
License: MIT
Types: extension
Size: 16.9 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/alexeyco/pi-statusline/master/docs/gallery/terminal.png",
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@alexeyco/pi-statusline

Compact statusline for the pi coding agent — published as a pi extension package.

Relocates status information in the pi TUI:

Footer — a single line: model • thinking • ctx%/window on the left, MCP: n right-aligned. The MCP count is read from ~/.pi/agent/mcp.json and refreshes when MCP servers change. Context usage turns orange above 70% and red above 90%.
Extension statuses (ctx.ui.setStatus) keep their own line below.

Install

pi install npm:@alexeyco/pi-statusline

Requires pi ≥ 0.76 (peer dependencies are * and resolved by pi install). The extension activates automatically on session start.

Migrating from a local copy: if you previously kept this extension in ~/.pi/agent/extensions/status-layout/, remove that directory after installing the package — otherwise both copies register and fight over the footer.

Development

git clone https://github.com/alexeyco/pi-statusline
cd pi-statusline
pi install "$(pwd)"   # local install; edits are live
make test             # unit tests (node:test, needs Node ≥ 22.18)
make check            # sanity checks (same as CI)

See CONTRIBUTING.md for branching and release flow.