pi-easy-footer

A footer extension and session banner for pi

Package details

← Back
extension

Install pi-easy-footer from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-easy-footer
Package
pi-easy-footer
Version
0.3.3
Published
Apr 23, 2026
Downloads
692/mo · 692/wk
Author
danmademe
License
MIT
Types
extension
Size
17.5 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/footer/index.ts",
    "./src/session-banner/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-easy-footer

A footer extension and session banner for pi.

npm version License: MIT

Install

pi install pi-easy-footer

Footer

A single-line status bar showing everything you need at a glance:

Section Details
Model Active AI model name
Directory Current working directory (popped)
Git branch Branch name with live status indicators
Worktree Worktree branch (when applicable)
Context bar Visual progress bar + % of context window used
Thinking level ◐ off, ◐ low, ◐ medium, ◐ high, etc.
Token stats ↑input ↓output R cache-read W cache-write $cost

Git status icons

The footer parses git status --porcelain=v2 for real-time accuracy:

Icon Meaning
●N N staged changes
~N N unstaged modifications
UN N untracked files
↑N N commits ahead of remote
↓N N commits behind remote

Session Banner

Automatically generates a title and banner for each session. It extracts the first user message, summarizes it into a short title, and picks an emoji based on keywords:

Keywords Emoji
bug, fix, error, crash 🐞
refactor, cleanup 🧹
test, spec 🧪
doc, readme 📝
release, deploy 🚀
design, ui, theme 🎨

Configuration

Override via environment variables:

Variable Default Description
PI_SESSION_BANNER_EMOJI auto Emoji to use (or auto for keyword detection)
PI_SESSION_BANNER_FRAME_COLOR dim Banner frame color
PI_SESSION_BANNER_TITLE_COLOR mdLink Title text color

Requirements

  • Nerd Font installed in your terminal for icons to render correctly.

License

MIT