pi-powerline-footer

A powerline-style status bar and welcome header extension for pi, the coding agent. Inspired by oh-my-pi.

Features

Welcome overlay — Branded splash screen shown as centered overlay on startup. Shows gradient logo, model info, keyboard tips, loaded AGENTS.md/extensions/skills/templates counts, and recent sessions. Auto-dismisses after 30 seconds or on any key press.

Rounded box design — Status renders directly in the editor's top border, not as a separate footer.

Live thinking level indicator — Shows current thinking level (thinking:off, thinking:med, etc.) with color-coded gradient. High and xhigh levels get a rainbow shimmer effect inspired by Claude Code's ultrathink.

Smart defaults — Nerd Font auto-detection for iTerm, WezTerm, Kitty, Ghostty, and Alacritty with ASCII fallbacks. Colors matched to oh-my-pi's dark theme.

Git integration — Async status fetching with 1s cache TTL. Automatically invalidates on file writes/edits. Shows branch, staged (+), unstaged (*), and untracked (?) counts.

Context awareness — Color-coded warnings at 70% (yellow) and 90% (red) context usage. Auto-compact indicator when enabled.

Token intelligence — Smart formatting (1.2k, 45M), subscription detection (shows "(sub)" vs dollar cost).

Installation

npx pi-powerline-footer

This copies the extension to ~/.pi/agent/extensions/powerline-footer/. Restart pi to activate.

Usage

Activates automatically. Toggle with /powerline, switch presets with /powerline <name>.

| Preset | Description | |--------|-------------| | default | Model, thinking, path (basename), git, context, tokens, cost | | minimal | Just path (basename), git, context | | compact | Model, git, cost, context | | full | Everything including hostname, time, abbreviated path | | nerd | Maximum detail for Nerd Font users | | ascii | Safe for any terminal |

Environment: POWERLINE_NERD_FONTS=1 to force Nerd Fonts, =0 for ASCII.

Thinking Level Display

The thinking segment shows live updates when you change thinking level:

| Level | Display | Color | |-------|---------|-------| | off | thinking:off | gray | | minimal | thinking:min | purple-gray | | low | thinking:low | blue | | medium | thinking:med | teal | | high | thinking:high | 🌈 rainbow | | xhigh | thinking:xhigh | 🌈 rainbow |

Path Display

The path segment supports three modes:

| Mode | Example | Description | |------|---------|-------------| | basename | powerline-footer | Just the directory name (default) | | abbreviated | …/extensions/powerline-footer | Full path with home abbreviated and length limit | | full | ~/.pi/agent/extensions/powerline-footer | Complete path with home abbreviated |

Configure via preset options: path: { mode: "full" }

Segments

pi · model · thinking · path · git · subagents · token_in · token_out · token_total · cost · context_pct · context_total · time_spent · time · session · hostname · cache_read · cache_write

Separators

powerline · powerline-thin · slash · pipe · dot · chevron · star · block · none · ascii