pi-cometix-footer

Cometix-style single-line footer for pi — model, path, git, tokens, cost & task time at a glance.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-cometix-footer
Package
pi-cometix-footer
Version
1.1.1
Published
Jul 26, 2026
Downloads
616/mo · 178/wk
Author
xichun123
License
MIT
Types
extension
Size
129.6 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "image": "https://cdn.jsdelivr.net/npm/pi-cometix-footer/assets/demo.png"
}

Security note

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

README

pi-cometix-footer

npm license pi package

Single-line cometix-style footer for pi — model, path, git, context window, session tokens, latest-response throughput, cost, and task time at a glance.

Look inspired by CCometixLine (MIT). Independent pi extension; own codebase.

Preview

cometix footer demo

π  GPT-5.6 Sol • max  |  > ~/agent/pi-cometix-footer  |  main ✓  |  2% 6.4k/372k  |  ↑13k ↓61 CH88.2%  |  󰄉 1m 23s · 42.3 tok/s  |  󰇁 0.284  |  MCP: 0/5 servers
Segment What it shows Color
Model Model name + thinking level (• high) cyan · level uses pi palette
Directory CWD, ~-relative yellow icon / green path
Git Branch · clean ✓ / dirty ● / conflict ⚠ · ahead ↑n / behind ↓n blue
Context Window fill pct tokens/window magenta → yellow (>70%) → red (>90%)
Tokens Session ↑in ↓out + latest cache hit CH% cyan
Cost Session cumulative USD cost reported by Pi (󰇁 0.000); omitted when zero/unavailable yellow
Activity Live task time (updated every second) + optional latest-response TPS; final values remain after the agent settles magenta
Statuses Extension / MCP status lines (if any) theme default

Segments are bold, separated by dim |, with Nerd Font icons (emoji fallback available).

Install

pi install npm:pi-cometix-footer

Or from git:

pi install git:github.com/Xichun123/pi-cometix-footer

Then in pi:

/reload

Footer and TPS are on by default. Toggle the footer or TPS independently:

/cometix-footer
/cometix-footer tps
/cometix-footer tps on
/cometix-footer tps off

TPS uses the final output-token count divided by the elapsed time from the first streamed output delta to response completion, so time to first token is excluded. It is omitted when a provider does not stream output deltas or report valid output-token usage.

Migrating from a loose file?
If you previously copied cometix-footer.ts into ~/.pi/agent/extensions/, remove that file first to avoid loading the footer twice.

Customize

Edit the installed package (or a local clone), then /reload.

Knob Where Purpose
ICON_MODE top of index.ts "nerd" (default) or "emoji" if no Nerd Font
DEFAULT_SHOW_TPS top of index.ts show latest-response TPS by default (true)
ICONS.nerd.* icon map per-segment Nerd Font codepoints
C.* color map 16-color SGR codes per segment
GIT_TTL near git cache git status refresh interval (ms, default 3000)

Nerd Font cheatsheet: https://www.nerdfonts.com/cheat-sheet

Local install for hacking:

git clone https://github.com/Xichun123/pi-cometix-footer.git
pi install ./pi-cometix-footer

Requirements

  • pi (peer: @earendil-works/pi-coding-agent, @earendil-works/pi-tui)
  • A Nerd Font in your terminal — or set ICON_MODE = "emoji"

Credits

  • Visual language borrowed from CCometixLine by Haleclipse (MIT)
  • Built as a pi extension package

License

MIT © Xichun123