pi-easy-footer

A footer extension and session banner for pi.

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