pi-jefferson

A starship-style statusline for pi — instruments, a real layout, and per-instrument formatting.

Packages

Package details

extension

Install pi-jefferson from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-jefferson
Package
pi-jefferson
Version
0.14.0
Published
Nov 17, 2026
Downloads
4,338/mo · 1,363/wk
Author
joelleibow
License
MIT
Types
extension
Size
148.4 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/joelleibow/pi-jefferson/main/docs/images/jefferson-cosmic-star-dragon.png",
  "extensions": [
    "./extensions/jefferson.ts"
  ]
}

Security note

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

README

pi-jefferson

A starship-style statusline for pi. You place instruments in rows, Jefferson lays the rows out across the footer, and each instrument takes its own format.

The name is a nod to the lineage: Jefferson Airplane became Jefferson Starship became Starship.

Jefferson's footer in a cosmic star-dragon theme

Status

Pre-1.0. A configuration file written for an earlier version can be rejected, and Upgrading says what to change.

Install

pi install npm:pi-jefferson

Then run /jefferson. It reports whether the footer is installed and how many rows it renders.

Configure

Write a pi-jefferson.json to choose your instruments. This one puts the model on the left and the context window on the right:

{
  "rows": [
    [
      { "instrument": "model" },
      { "instrument": "context", "align": "right" }
    ]
  ],
  "instruments": {
    "model": {
      "format": "🧠: $model from $provider",
      "style": { "fg": "accent", "bold": true }
    },
    "context": {
      "format": "$bar $percent"
    }
  }
}

Configuration says where the file goes, and lists every key and every rule.

Documentation

  • Configuration: where the file lives, rows, names, alignment, the gap between rows, and what Jefferson rejects.
  • Instruments: every instrument, with its variables, options and defaults.
  • Formats: how an instrument's text is written, with variables, forms, modifiers, styles and the bar.
  • Notices: the notice instrument, its kinds, their words and how long they show.
  • Provide instruments from your extension: put your own extension's instruments in the footer.

Why another statusline

pi-powerline-footer is excellent, and it is the reason this package exists. It renders its row as one joined string from a fixed set of presets. So its segment spacing is fixed, a segment cannot carry another segment's value, and its groups are one flat list rather than rows.

This package is for when you want a layout and per-instrument formatting, with the pi session's own data behind each instrument. The layout means rows, alignment, a gap between rows and a stated truncation rule.

Contributing

CONTRIBUTING.md has the development and release steps.

License

MIT