pi-statusline

Persistent status footer for PI coding agent. Displays a 2-line capsule-style status bar using Powerline separators with a cycling orange → yellow → aqua → blue → bg2 → bg3 color palette.

Display

 provider/model   thinking   main  + 42 - 7  ~/Code/03-pi
 200k  ↑ 89k → 12k / 77k 64%  ↓ 8k  ▓▓▓▓▓▓░░░░ 54.8% free

Each segment is a colored pill with Powerline separators. Colors cycle through orange, yellow, aqua, blue, bg2, bg3.

Line 1 — Session info

| Segment | Source | Example | |---------|--------|---------| | Model name | ctx.model.id (with provider prefix) | anthropic/claude-opus-4-7 | | Thinking level | thinking_level_select event | high | | Git branch | footerData.getGitBranch() | main | | Code changes | git diff --shortstat HEAD | + 42 - 7 | | Current path | ctx.cwd (shortened) | ~/Code/03-pi |

Line 2 — Context + token usage

| Segment | Description | |---------|-------------| | Context window | Total context window size | | Input breakdown | Total input → cache miss / cache hit (hit rate %) | | Output | Total output tokens | | Available bar | █/░ bar (used in bg2, free in bg1 on bg3 background) with remaining % free |

Architecture

Uses ctx.ui.setFooter() to register a persistent 2-line footer component. Renders with raw ANSI 24-bit escape codes (no dependency on PI theme colors).

State is cached in a closure and refreshed on lifecycle events:

• session_start — initial setup: model, provider, context/git/usage data
• model_select — model and provider update
• thinking_level_select — thinking level from dedicated event
• turn_start / turn_end — context usage, git stats, and token metrics
• footerData.onBranchChange() — git branch updates

Key functions

• buildPill(segments) — renders capsule segments with Powerline open/body/arrow/close
• segColor(idx) — returns cycling color from orange → yellow → aqua → blue → bg2 → bg3
• collectGitStats(cwd) — parses git diff --shortstat HEAD for insertion/deletion counts
• refreshUsage(ctx) — aggregates input, output, cacheRead, cacheWrite from conversation branch
• buildLines(width, state) — renders both footer lines

Changelog

See CHANGELOG.md.