pi-jefferson
A starship-style statusline for pi — instruments, a real layout, and per-instrument formatting.
Package details
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.

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
noticeinstrument, 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