pi-powerbar

A pi extension that renders a persistent powerline-style status bar with left-aligned and right-aligned segments.

Any other pi extension can update segments by emitting a single powerbar:update event — no imports or dependencies required.

Install

pi install npm:@juanibiapina/pi-powerbar

⚠️ Load Order: pi-powerbar must appear after pi-extension-settings and before any segment-emitting extensions in your packages array in ~/.pi/settings.json. It registers settings at load time (requiring pi-extension-settings to already be loaded), and segment emitters send events that pi-powerbar must be ready to receive.

Usage

The powerbar renders a widget with two sides, like tmux:

Producing segments

Any extension can register and update a segment. First, register the segment so it appears in the settings menu:

pi.events.emit("powerbar:register-segment", {
  id: "git-branch",
  label: "Git Branch",
});

Then update it with data:

pi.events.emit("powerbar:update", {
  id: "git-branch",
  text: "main",
  icon: "⎇",
  color: "accent",
});

To remove a segment:

pi.events.emit("powerbar:update", {
  id: "git-branch",
  text: undefined,
});

Built-in segments

Segment ID	Description
git-branch	Current git branch (refreshes after bash commands)
tokens	Cumulative input/output tokens and session cost (e.g. ↑9 ↓270 $0.11)
context-usage	Context window usage as a progress bar with percentage
provider	Current LLM provider name (e.g. anthropic, openai)
model	Current model name and thinking level
sub-hourly	Hourly subscription usage from pi-sub-core
sub-weekly	Weekly subscription usage from pi-sub-core

Configuration

Settings are managed through pi-extension-settings and can be changed via the /extension-settings command in pi.

Setting	Description	Default
Left segments	Segments shown on the left side (ordered multi-select menu)	git-branch,tokens,context-usage
Right segments	Segments shown on the right side (ordered multi-select menu)	provider,model,sub-hourly,sub-weekly
Separator	String drawn between segments on the same side	│
Placement	Where the powerbar appears (belowEditor or aboveEditor)	belowEditor
Bar width	Width of progress bars in characters (4–24)	10

The left and right segment settings open an interactive menu where you can toggle segments on/off and reorder them with Shift+↑/↓. All segments registered via powerbar:register-segment appear as options. Segments not listed in either side are ignored.

Development

npm install
npm run check    # lint + typecheck
npm run build    # compile to dist/
npm run dev      # watch mode

License

MIT