@pi-archimedes/footer

Session details without scrolling.

A long session drags context out of reach fast. The footer keeps the essentials pinned to the bottom of the terminal — where you are, which model you're running, how deep you are into the context window, and what you've spent — laying them out without clipping on any viewport width. When subagents run, their tokens and costs land in the same view, so the number you're watching is the whole run.

Install

Standalone:

pi install npm:@pi-archimedes/footer

Or the full suite instead:

pi install npm:pi-archimedes

New to Pi? Pi itself is a one-time global install and needs Node.js ≥ 22.19.0:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

After installing Pi, choose one installation command above, then cd into your project and run pi. Inside the session, /login signs you in and /model picks a model — the setup section walks through the whole first run. A running session picks the footer up with /reload.

What you get

• Session line — working directory, active git branch (or nearest jj bookmark in a jj repo) with clean/dirty indicator, worktree badge, active model, and thinking level.
• Token ledger — input (↑) and output (↓) tokens, cache read/write, and the live accumulated dollar cost of the session.
• Context bar — colour-coded (green → yellow → red). It shows consumption: how much of the context window is used, not how much headroom is left.
• Adaptive layout — one compact line on wide viewports; it wraps to the lines it needs as the terminal narrows instead of truncating essential data.
• Subagent aggregation — in the suite, a subagent reports its tokens and cost on its own tool result, which this footer's session scan already totals, so worker spend and main-session spend read as one number. (It used to arrive a second way, over core's bus, which meant the same money was counted twice.)

Two honest caveats: the ledger reflects usage and pricing as reported to the session — it's a live read of what Pi has accounted, not a guaranteed provider invoice, and not a tally of every background model call. And the context bar tracks consumption, not remaining headroom.

Settings

~/.pi/agent/settings.json, under archimedes.footer (strict JSON):

| Setting | Type | Default | Description | |---------|------|---------|-------------| | splitThreshold | number | 150 | Minimum terminal columns for the single-line layout. Below it, the footer uses the structured multi-line layout; above it, it stays single-line and wraps only if content overflows. | | branchMaxLength | number | 0 | Max columns for the branch or jj bookmark name, truncated with …. 0 = unlimited. Git status indicators are never truncated. Applies on next session or /reload. |

In the suite the setting also appears in /archimedes (when the panel has a control for it); /reload applies it. On/off is managed by the suite: toggle via /plugins (archimedes.footer.enabled, default on).

← Back to pi-archimedes