@kaishin/pi-footer

Standalone pi coding-agent extension that installs a fixed editor-style footer at the bottom of the TUI.

What it renders

A single-line footer (responsive across five widths: gallery, balanced, focus, telemetry, safe) showing, from left to right:

• Activity indicator — ● Ready / spinner + working phrase while the agent is responding
• Model id (+ abbreviated thinking level on wider terminals)
• Git branch (with ✦ if the worktree is dirty)
• Extension statuses (only on gallery width, max 24 visible cols)
• Token IO — ↑ input ↓ output since the session began
• Cache hit rate — ↯ %
• Context window — █░ gauge %/total

The footer hides pi's built-in working spinner (ctx.ui.setWorkingVisible(false)) and replaces the default status line.

Install

From the pi repo:

# install as an npm-linked extension
cd packages/coding-agent && npm link
cd /path/to/pi-footer && npm link @earendil-works/pi-coding-agent

Or, in another extension consumer, add this package as a dependency and reference it from your package.json:

{
	"pi": {
		"extensions": ["./node_modules/@kaishin/pi-footer/src/index.ts"]
	}
}

Test

npm install
npm test
npm run check

The tests cover:

• Lifecycle event registration
• Full-width rendering (160-col gallery)
• Responsive mode breakpoints (132 / 96 / 72 / 56 / 55)
• Pre-response context indicator (◔ —/200k)
• Width invariant: rendered line never exceeds the available width for 1 ≤ width ≤ 200

Origin

Extracted from packages/coding-agent/src/extensions/bar-footer/ in the kaishin/pi fork of earendil-works/pi at v0.85.1. The fork originally vendored this as a built-in; this package makes it independently installable so the fork doesn't need to carry a custom copy.