pi-lite-footer

中文文档 | English

A lightweight segmented status bar for the Pi coding agent — git status, model info, token stats, and more, in a single line.

pi install npm:pi-lite-footer

Features

• Segmented status bar — clean, minimal status display with 10 separator styles
• Git integration — branch name, staged / unstaged / untracked file counts
• 12 built-in segments — model, thinking, path, git, context usage, token I/O, cache stats, and extension statuses
• Nerd Font support — auto-detects your terminal and falls back to ASCII glyphs
• Responsive layout — hides segments that don't fit instead of wrapping
• Configurable bottom bar — optionally display selected segments below the input area

Installation

pi install npm:pi-lite-footer

Quick Start

Once installed, the footer activates automatically. Toggle it inside Pi:

/lite-footer        # Enable
/lite-footer off    # Disable

Configuration

All settings live in ~/.pi/agent/settings.json under the liteFooter key. No runtime commands needed — edit the file and restart Pi.

// ~/.pi/agent/settings.json
{
  "liteFooter": {
    // Enable/disable (default: true)
    "enabled": true,

    // Segments shown above the editor (default below)
    "topBar": ["model", "thinking", "path", "git", "context_pct"],

    // Segments shown below the input area (default: extension statuses)
    "bottomBar": ["extension_statuses"],

    // Separator style: arrow | arrow-thin | slash | pipe | block | none | ascii | dot | chevron | star
    "separator": "pipe",

    // Override icons (optional, uses Nerd Font glyphs by default)
    "icons": {
      "model": "🤖",
      "folder": "📁",
      "branch": "🔀"
    }
  }
}

Example: token stats in the bottom bar

{
  "liteFooter": {
    "topBar": ["model", "thinking", "path", "git", "context_pct"],
    "bottomBar": ["token_in", "token_out", "cache_hit"],
    "separator": "dot"
  }
}

Segments

Segment	Description
model	Current AI model name
path	Current working directory
git	Branch + staged / unstaged / untracked counts
context_pct	Context window usage (%)
thinking	Active thinking level (hidden when off)
token_in	Input tokens
token_out	Output tokens
token_total	Total tokens
cache_read	Cache reads
cache_write	Cache writes
cache_hit	Cache hit rate
extension_statuses	Third-party extension statuses

Separator Styles

Style	Glyph	Style	Glyph
arrow		arrow-thin
slash	/	pipe	|
block	█	none
ascii	>	dot	·
chevron	»	star	✦

Development

npm install          # Install dependencies
npm run dev          # Start Pi with the extension loaded
npm run typecheck    # Type-check with tsc
npm run lint         # Lint with Biome
npm test             # Run tests

License

MIT