@erlin-ai/pi-footer-wrap 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-09-20
+
+### Added
+
+- Takes over the pi footer and re-renders the exact default footer content:
+  cwd/branch/session-name, token stats (input/output/cache/cache-hit/cost/
+  context%) with right-aligned model + thinking level, and all extension
+  statuses.
+- Adaptive wrapping: statuses wrap across as many lines as needed (breaking
+  between statuses first, hard-wrapping single over-wide statuses) — nothing
+  is truncated with "…", unlike the default footer.
+- `/footer-wrap` command to toggle back to pi's built-in footer at any time.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 erlinerd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# pi-footer-wrap
+
+[![CI](https://github.com/erlinerd/pi-footer-wrap/actions/workflows/ci.yml/badge.svg)](https://github.com/erlinerd/pi-footer-wrap/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+English | [中文](README.zh-CN.md)
+
+**Adaptive-wrapping footer for the pi coding agent.** Takes over the default footer with exactly one behavior change: **wrap when it doesn't fit — never truncate**.
+
+The default footer squeezes all extension statuses onto a single line and cuts them off with `…` when the terminal is too narrow — with many extensions installed, data silently disappears. This plugin re-renders the same three lines:
+
+```text
+~/code/xxx (main) • session name
+↑12k ↓3.4k R45k W1k CH88.8% $0.123 45.6%/200k (auto)     glm-5.3-flash • max
+45.2 tok/s · mcp: 8 tools ready · lf: tracing on · …
+```
+
+- **Line 1**: cwd (`~` abbreviated), git branch, session name
+- **Line 2**: cumulative ↑input ↓output, R/W cache, cache-hit rate, cost, context usage (recolors past 70%/90%), model name + thinking level on the right
+- **Line 3+**: **all** extension statuses, sorted by key; wraps onto new lines when out of width, hard-wraps single over-wide statuses — nothing is dropped
+
+Data sources and formatting mirror the pi 0.85.x default footer field by field (`sessionManager` entries, `getContextUsage`, `ctx.thinkingLevel`, `PI_EXPERIMENTAL`, the kimi `(sub)` marker, …) — only the wrapping strategy differs.
+
+## Install
+
+```bash
+pi install github:erlinerd/pi-footer-wrap      # GitHub
+pi install npm:@erlin-ai/pi-footer-wrap     # npm
+pi install /path/to/pi-footer-wrap          # local development
+```
+
+Takes effect in new sessions.
+
+## Toggle
+
+```bash
+/footer-wrap   # switch back to pi's default footer; run again to re-enable
+```
+
+## Development
+
+```bash
+npm install
+npm test        # tsx --test
+npx tsc --noEmit
+```
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,50 @@
+# pi-footer-wrap
+
+[![CI](https://github.com/erlinerd/pi-footer-wrap/actions/workflows/ci.yml/badge.svg)](https://github.com/erlinerd/pi-footer-wrap/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+[English](README.md) | 中文
+
+pi coding agent 的**自适应换行 footer**。接管 pi 默认 footer，唯一的行为差异：**放不下就换行，绝不截断**。
+
+pi 默认 footer 把所有扩展状态挤在一行，超出终端宽度就截断加 `…`——装了多个扩展后数据会悄悄丢失。本插件完整复刻默认 footer 的全部三行内容：
+
+```text
+~/code/xxx (main) • 会话名
+↑12k ↓3.4k R45k W1k CH88.8% $0.123 45.6%/200k (auto)     glm-5.3-flash • max
+45.2 tok/s · mcp: 8 tools ready · lf: tracing on · …
+```
+
+- **第 1 行**：目录（`~` 缩写）、git 分支、会话名
+- **第 2 行**：累计 ↑输入 ↓输出 R/W 缓存、缓存命中率、成本、上下文占用（超 70%/90% 变色）、右侧模型名 + thinking 档位
+- **第 3 行起**：**所有**扩展状态，按 key 字母序，装不下自动换行；单条超宽的字内硬换行——一个字都不少
+
+数据来源与格式逐字段对齐 pi 0.85.x 默认 footer（`sessionManager` entries、`getContextUsage`、`ctx.thinkingLevel`、`PI_EXPERIMENTAL`、kimi `(sub)` 标记等），差异只有换行策略。
+
+## 安装
+
+```bash
+pi install github:erlinerd/pi-footer-wrap      # GitHub
+pi install npm:@erlin-ai/pi-footer-wrap     # npm
+pi install /path/to/pi-footer-wrap          # 本地开发
+```
+
+新开会话即生效。
+
+## 切换
+
+```bash
+/footer-wrap   # 随时切回 pi 默认 footer；再敲一次切回来
+```
+
+## 开发
+
+```bash
+npm install
+npm test        # tsx --test
+npx tsc --noEmit
+```
+
+## License
+
+MIT

package/lib/footer.mjs.del

@@ -0,0 +1,170 @@
+// pi-footer-wrap — pure footer layout/format helpers (no pi runtime imports).
+// Mirrors pi 0.85.x default footer formatting (dist/modes/interactive/components/footer.js)
+// so the wrapped footer shows the SAME data, minus the "truncate with …" behavior.
+
+import { visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+
+/** Same token compaction as the pi default footer. */
+export function formatTokens(count) {
+  if (count < 1000) return count.toString();
+  if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
+  if (count < 1000000) return `${Math.round(count / 1000)}k`;
+  if (count < 10000000) return `${(count / 1000000).toFixed(1)}M`;
+  return `${Math.round(count / 1000000)}M`;
+}
+
+/** Replace $HOME with ~ like the default footer. */
+export function formatCwdForFooter(cwd, home) {
+  if (!home) return cwd;
+  const resolvedHome = home.endsWith("/") ? home.slice(0, -1) : home;
+  if (cwd === resolvedHome) return "~";
+  if (cwd.startsWith(resolvedHome + "/"))
+    return "~" + cwd.slice(resolvedHome.length);
+  return cwd;
+}
+
+/** Collapse newlines/tabs/multi-spaces (statuses must stay line-safe). */
+export function sanitizeStatusText(text) {
+  return String(text)
+    .replace(/[\r\n\t]/g, " ")
+    .replace(/ +/g, " ")
+    .trim();
+}
+
+/**
+ * Sum usage across session entries the way the default footer does:
+ * assistant messages, toolResult messages carrying usage, branch_summary and
+ * compaction entries. Also tracks the latest cache-hit rate (per assistant turn).
+ */
+export function collectUsage(entries) {
+  const t = {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    cost: 0,
+    latestCacheHitRate: undefined,
+  };
+  for (const e of entries ?? []) {
+    const u = e?.message?.usage ?? e?.usage;
+    if (!u) continue;
+    t.input += u.input || 0;
+    t.output += u.output || 0;
+    t.cacheRead += u.cacheRead || 0;
+    t.cacheWrite += u.cacheWrite || 0;
+    t.cost += u.cost?.total || 0;
+    // Cache-hit rate tracks the latest ASSISTANT prompt only (matches pi:
+    // compaction/branch_summary usage must not overwrite it).
+    if (e?.message?.role === "assistant") {
+      const prompt = (u.input || 0) + (u.cacheRead || 0) + (u.cacheWrite || 0);
+      if (prompt > 0)
+        t.latestCacheHitRate = ((u.cacheRead || 0) / prompt) * 100;
+    }
+  }
+  return t;
+}
+
+/**
+ * Stats parts, in the default footer's order and format.
+ * @param {object} opts
+ * @param {object} opts.totals
+ * @param {number} opts.ctxPercent
+ * @param {number} opts.contextWindow
+ * @param {boolean} [opts.autoCompact=true]
+ * @param {boolean} [opts.subscription=false]
+ * @param {string|null} [opts.experimentalBadge]
+ * @param {(text: string, level?: string) => string} [opts.colorize]
+ */
+export function buildStatsParts({
+  totals,
+  ctxPercent,
+  contextWindow,
+  autoCompact = true,
+  subscription = false,
+  experimentalBadge = null,
+  colorize,
+}) {
+  const parts = [];
+  if (totals.input) parts.push(`↑${formatTokens(totals.input)}`);
+  if (totals.output) parts.push(`↓${formatTokens(totals.output)}`);
+  if (totals.cacheRead) parts.push(`R${formatTokens(totals.cacheRead)}`);
+  if (totals.cacheWrite) parts.push(`W${formatTokens(totals.cacheWrite)}`);
+  if (
+    (totals.cacheRead > 0 || totals.cacheWrite > 0) &&
+    totals.latestCacheHitRate !== undefined
+  ) {
+    parts.push(`CH${totals.latestCacheHitRate.toFixed(1)}%`);
+  }
+  if (totals.cost || subscription) {
+    parts.push(`$${totals.cost.toFixed(3)}${subscription ? " (sub)" : ""}`);
+  }
+  const auto = autoCompact ? " (auto)" : "";
+  const pctText = `${ctxPercent.toFixed(1)}%/${formatTokens(contextWindow)}${auto}`;
+  const level =
+    ctxPercent > 90 ? "error" : ctxPercent > 70 ? "warning" : undefined;
+  parts.push(colorize ? colorize(pctText, level) : pctText);
+  if (experimentalBadge) parts.push(experimentalBadge);
+  return parts;
+}
+
+/**
+ * Stats line with right-aligned model — same layout as the default footer,
+ * but instead of truncating, the model drops to its own right-aligned line,
+ * and in ultra-narrow terminals both parts hard-wrap. No data is dropped.
+ */
+export function layoutStats(parts, right, width, minPad = 2) {
+  const left = parts.join(" ");
+  const lw = visibleWidth(left);
+  const rw = visibleWidth(right);
+  if (lw + minPad + rw <= width) {
+    return [left + " ".repeat(width - lw - rw) + right];
+  }
+  const wrap = (s) =>
+    visibleWidth(s) <= width
+      ? [s]
+      : String(wrapTextWithAnsi(s, width)).split("\n");
+  if (lw <= width || rw <= width) {
+    const leftLines = lw <= width ? [left] : wrap(left);
+    const rightLines =
+      rw <= width ? [" ".repeat(Math.max(1, width - rw)) + right] : wrap(right);
+    return [...leftLines, ...rightLines];
+  }
+  return [...wrap(left), ...wrap(right)];
+}
+
+/**
+ * Pack extension statuses onto as few lines as fit, breaking BETWEEN statuses
+ * first; a single status wider than the terminal is hard-wrapped. Nothing is
+ * ever truncated or dropped (unlike the default footer's "…").
+ */
+export function wrapStatuses(statuses, width, sep = " · ") {
+  const lines = [];
+  let cur = "";
+  const sepW = visibleWidth(sep);
+  for (const raw of statuses ?? []) {
+    const s = String(raw);
+    if (!s) continue;
+    if (visibleWidth(s) > width) {
+      if (cur) {
+        lines.push(cur);
+        cur = "";
+      }
+      const wrapped = wrapTextWithAnsi(s, width);
+      const pieces = Array.isArray(wrapped)
+        ? wrapped
+        : String(wrapped).split("\n");
+      for (const piece of pieces) lines.push(piece);
+      continue;
+    }
+    if (!cur) {
+      cur = s;
+    } else if (visibleWidth(cur) + sepW + visibleWidth(s) <= width) {
+      cur += sep + s;
+    } else {
+      lines.push(cur);
+      cur = s;
+    }
+  }
+  if (cur) lines.push(cur);
+  return lines;
+}

package/lib/footer.ts

@@ -0,0 +1,211 @@
+// pi-footer-wrap — pure footer layout/format helpers (no pi runtime imports).
+// Mirrors pi 0.85.x default footer formatting (dist/modes/interactive/components/footer.js)
+// so the wrapped footer shows the SAME data, minus the "truncate with …" behavior.
+
+import { visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+
+/** Loose shape of the usage object pi attaches to messages/entries. */
+export interface UsageLike {
+  input?: number;
+  output?: number;
+  cacheRead?: number;
+  cacheWrite?: number;
+  totalTokens?: number;
+  cost?: { total?: number };
+}
+
+/** Loose shape of a pi session entry we care about (pi entries carry arbitrary extra fields). */
+export interface SessionEntryLike {
+  [key: string]: unknown;
+  message?: { role?: string; usage?: UsageLike };
+  usage?: UsageLike;
+}
+
+export interface UsageTotals {
+  input: number;
+  output: number;
+  cacheRead: number;
+  cacheWrite: number;
+  cost: number;
+  latestCacheHitRate: number | undefined;
+}
+
+export interface BuildStatsPartsOptions {
+  totals: UsageTotals;
+  ctxPercent: number;
+  contextWindow: number;
+  autoCompact?: boolean;
+  subscription?: boolean;
+  experimentalBadge?: string | null;
+  colorize?: (text: string, level?: "warning" | "error") => string;
+}
+
+/** Same token compaction as the pi default footer. */
+export function formatTokens(count: number): string {
+  if (count < 1000) return count.toString();
+  if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
+  if (count < 1000000) return `${Math.round(count / 1000)}k`;
+  if (count < 10000000) return `${(count / 1000000).toFixed(1)}M`;
+  return `${Math.round(count / 1000000)}M`;
+}
+
+/** Replace $HOME with ~ like the default footer. */
+export function formatCwdForFooter(cwd: string, home: string): string {
+  if (!home) return cwd;
+  const resolvedHome = home.endsWith("/") ? home.slice(0, -1) : home;
+  if (cwd === resolvedHome) return "~";
+  if (cwd.startsWith(resolvedHome + "/"))
+    return "~" + cwd.slice(resolvedHome.length);
+  return cwd;
+}
+
+/** Collapse newlines/tabs/multi-spaces (statuses must stay line-safe). */
+export function sanitizeStatusText(text: unknown): string {
+  return String(text)
+    .replace(/[\r\n\t]/g, " ")
+    .replace(/ +/g, " ")
+    .trim();
+}
+
+/**
+ * Sum usage across session entries the way the default footer does:
+ * assistant messages, toolResult messages carrying usage, branch_summary and
+ * compaction entries. Also tracks the latest cache-hit rate (per assistant turn).
+ */
+export function collectUsage(entries?: SessionEntryLike[] | null): UsageTotals {
+  const t: UsageTotals = {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    cost: 0,
+    latestCacheHitRate: undefined,
+  };
+  for (const e of entries ?? []) {
+    const u: UsageLike | undefined = e?.message?.usage ?? e?.usage;
+    if (!u) continue;
+    t.input += u.input || 0;
+    t.output += u.output || 0;
+    t.cacheRead += u.cacheRead || 0;
+    t.cacheWrite += u.cacheWrite || 0;
+    t.cost += u.cost?.total || 0;
+    // Cache-hit rate tracks the latest ASSISTANT prompt only (matches pi:
+    // compaction/branch_summary usage must not overwrite it).
+    if (e?.message?.role === "assistant") {
+      const prompt = (u.input || 0) + (u.cacheRead || 0) + (u.cacheWrite || 0);
+      if (prompt > 0)
+        t.latestCacheHitRate = ((u.cacheRead || 0) / prompt) * 100;
+    }
+  }
+  return t;
+}
+
+/**
+ * Stats parts, in the default footer's order and format.
+ * `colorize` applies theme colors (level: "warning" | "error");
+ * `subscription` adds the Kimi-style " (sub)" cost marker;
+ * `experimentalBadge` is a pre-colored "• xp" string, or null.
+ */
+export function buildStatsParts({
+  totals,
+  ctxPercent,
+  contextWindow,
+  autoCompact = true,
+  subscription = false,
+  experimentalBadge = null,
+  colorize,
+}: BuildStatsPartsOptions): string[] {
+  const parts: string[] = [];
+  if (totals.input) parts.push(`↑${formatTokens(totals.input)}`);
+  if (totals.output) parts.push(`↓${formatTokens(totals.output)}`);
+  if (totals.cacheRead) parts.push(`R${formatTokens(totals.cacheRead)}`);
+  if (totals.cacheWrite) parts.push(`W${formatTokens(totals.cacheWrite)}`);
+  if (
+    (totals.cacheRead > 0 || totals.cacheWrite > 0) &&
+    totals.latestCacheHitRate !== undefined
+  ) {
+    parts.push(`CH${totals.latestCacheHitRate.toFixed(1)}%`);
+  }
+  if (totals.cost || subscription) {
+    parts.push(`$${totals.cost.toFixed(3)}${subscription ? " (sub)" : ""}`);
+  }
+  const auto = autoCompact ? " (auto)" : "";
+  const pctText = `${ctxPercent.toFixed(1)}%/${formatTokens(contextWindow)}${auto}`;
+  const level: "error" | "warning" | undefined =
+    ctxPercent > 90 ? "error" : ctxPercent > 70 ? "warning" : undefined;
+  parts.push(colorize ? colorize(pctText, level) : pctText);
+  if (experimentalBadge) parts.push(experimentalBadge);
+  return parts;
+}
+
+/**
+ * Stats line with right-aligned model — same layout as the default footer,
+ * but instead of truncating, the model drops to its own right-aligned line,
+ * and in ultra-narrow terminals both parts hard-wrap. No data is dropped.
+ */
+export function layoutStats(
+  parts: string[],
+  right: string,
+  width: number,
+  minPad = 2,
+): string[] {
+  const left = parts.join(" ");
+  const lw = visibleWidth(left);
+  const rw = visibleWidth(right);
+  if (lw + minPad + rw <= width) {
+    return [left + " ".repeat(width - lw - rw) + right];
+  }
+  const wrap = (s: string): string[] =>
+    visibleWidth(s) <= width
+      ? [s]
+      : String(wrapTextWithAnsi(s, width)).split("\n");
+  if (lw <= width || rw <= width) {
+    const leftLines = lw <= width ? [left] : wrap(left);
+    const rightLines =
+      rw <= width ? [" ".repeat(Math.max(1, width - rw)) + right] : wrap(right);
+    return [...leftLines, ...rightLines];
+  }
+  return [...wrap(left), ...wrap(right)];
+}
+
+/**
+ * Pack extension statuses onto as few lines as fit, breaking BETWEEN statuses
+ * first; a single status wider than the terminal is hard-wrapped. Nothing is
+ * ever truncated or dropped (unlike the default footer's "…").
+ * `sep` may contain ANSI escapes — packing math uses its visible width.
+ */
+export function wrapStatuses(
+  statuses: Iterable<string> | null | undefined,
+  width: number,
+  sep = " · ",
+): string[] {
+  const lines: string[] = [];
+  let cur = "";
+  const sepW = visibleWidth(sep);
+  for (const raw of statuses ?? []) {
+    const s = String(raw);
+    if (!s) continue;
+    if (visibleWidth(s) > width) {
+      if (cur) {
+        lines.push(cur);
+        cur = "";
+      }
+      const wrapped = wrapTextWithAnsi(s, width);
+      const pieces = Array.isArray(wrapped)
+        ? wrapped
+        : String(wrapped).split("\n");
+      for (const piece of pieces) lines.push(piece);
+      continue;
+    }
+    if (!cur) {
+      cur = s;
+    } else if (visibleWidth(cur) + sepW + visibleWidth(s) <= width) {
+      cur += sep + s;
+    } else {
+      lines.push(cur);
+      cur = s;
+    }
+  }
+  if (cur) lines.push(cur);
+  return lines;
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@erlin-ai/pi-footer-wrap",
+  "version": "0.1.0",
+  "description": "Adaptive-wrapping footer for the pi coding agent: takes over the default footer and wraps extension statuses across lines instead of truncating them. No data is dropped.",
+  "type": "module",
+  "files": [
+    "src",
+    "lib",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "scripts": {
+    "test": "tsx --test test/*.test.ts"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-coding-agent",
+    "extension",
+    "footer",
+    "wrap"
+  ],
+  "license": "MIT",
+  "author": "erlinerd",
+  "homepage": "https://github.com/erlinerd/pi-footer-wrap#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/erlinerd/pi-footer-wrap.git"
+  },
+  "bugs": {
+    "url": "https://github.com/erlinerd/pi-footer-wrap/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.2",
+    "tsx": "^4.23.14",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-tui": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,139 @@
+/**
+ * pi-footer-wrap — takes over the pi footer and wraps instead of truncating.
+ *
+ * pi's default footer joins ALL extension statuses on one line and cuts it
+ * off with "…" when it doesn't fit. With many extensions installed, data is
+ * silently lost. This plugin reproduces the default footer's three lines
+ * (pwd/branch/session-name, token stats + model, extension statuses) but
+ * wraps every line adaptively — nothing is dropped.
+ *
+ * /footer-wrap toggles back to pi's default footer at any time.
+ */
+import { wrapTextWithAnsi, visibleWidth } from "@earendil-works/pi-tui";
+import {
+  buildStatsParts,
+  collectUsage,
+  formatCwdForFooter,
+  layoutStats,
+  sanitizeStatusText,
+  wrapStatuses,
+} from "../lib/footer";
+
+function wrapToLines(text: string, width: number): string[] {
+  if (visibleWidth(text) <= width) return [text];
+  const wrapped = wrapTextWithAnsi(text, width);
+  return Array.isArray(wrapped) ? wrapped : String(wrapped).split("\n");
+}
+
+export default function (pi: any) {
+  let enabled = true;
+
+  function renderFooter(ctx: any, theme: any, footerData: any, width: number) {
+    const colorize = (text: string, level?: string) =>
+      level === "error"
+        ? theme.fg("error", text)
+        : level === "warning"
+          ? theme.fg("warning", text)
+          : text;
+
+    // Line 1 — cwd (branch) • session name   (same format as default)
+    const home = process.env.HOME || process.env.USERPROFILE || "";
+    const cwd = ctx.sessionManager?.getCwd?.() || process.cwd();
+    let pwd = formatCwdForFooter(cwd, home);
+    const branch = footerData?.getGitBranch?.() ?? null;
+    if (branch) pwd += ` (${branch})`;
+    const sessionName = ctx.sessionManager?.getSessionName?.();
+    if (sessionName) pwd += ` • ${sessionName}`;
+
+    // Line 2 — ↑in ↓out R… W… CH…% $cost ctx%/window (auto)   + model right
+    const totals = collectUsage(ctx.sessionManager?.getEntries?.() ?? []);
+    const cu = ctx.getContextUsage?.() ?? null;
+    const subscription = ctx.model?.provider === "kimi-coding";
+    const experimentalBadge =
+      process.env.PI_EXPERIMENTAL === "1"
+        ? `${theme.fg("dim", "•")} ${theme.bold(theme.fg("warning", "xp"))}`
+        : null;
+    const parts = buildStatsParts({
+      totals,
+      ctxPercent: cu?.percent ?? 0,
+      contextWindow: cu?.contextWindow ?? ctx.model?.contextWindow ?? 0,
+      autoCompact: ctx.session?.autoCompactionEnabled ?? true,
+      subscription,
+      experimentalBadge,
+      colorize,
+    });
+    const model = ctx.model;
+    let right = model?.id || "no-model";
+    if (model?.reasoning) {
+      const level = ctx.thinkingLevel || "off";
+      right =
+        level === "off" ? `${right} • thinking off` : `${right} • ${level}`;
+    }
+    if ((footerData?.getAvailableProviderCount?.() ?? 1) > 1 && model) {
+      right = `(${model.provider}) ${right}`;
+    }
+
+    // Lines 3+ — every extension status, sorted by key (like default), wrapped
+    let statuses: string[] = [];
+    try {
+      statuses = [...(footerData?.getExtensionStatuses?.() ?? [])]
+        .sort(([a], [b]) => String(a).localeCompare(String(b)))
+        .map(([, text]) => sanitizeStatusText(text as string))
+        .filter(Boolean);
+    } catch {
+      // statuses are best-effort
+    }
+
+    return [
+      ...wrapToLines(pwd, width),
+      ...layoutStats(parts, right, width),
+      ...wrapStatuses(statuses, width, theme.fg("dim", " · ")),
+    ];
+  }
+
+  function enable(ctx: any) {
+    try {
+      ctx.ui.setFooter((tui: any, theme: any, footerData: any) => {
+        let dispose = () => {};
+        try {
+          const unsub = footerData.onBranchChange(() => tui.requestRender());
+          if (typeof unsub === "function") dispose = unsub;
+        } catch {
+          // branch reactivity is optional
+        }
+        return {
+          dispose,
+          invalidate() {},
+          render(w: number) {
+            return renderFooter(ctx, theme, footerData, w);
+          },
+        };
+      });
+    } catch {
+      // non-TUI mode — ignore
+    }
+  }
+
+  pi.on("session_start", async (_event: any, ctx: any) => {
+    if (enabled) enable(ctx);
+  });
+
+  pi.registerCommand("footer-wrap", {
+    description:
+      "Toggle pi-footer-wrap (adaptive wrapping, no truncation) vs pi default footer",
+    handler: async (_args: any, ctx: any) => {
+      enabled = !enabled;
+      if (enabled) {
+        enable(ctx);
+        ctx.ui.notify("footer-wrap on — full statuses, wrapped", "info");
+      } else {
+        try {
+          ctx.ui.setFooter(undefined);
+        } catch {
+          // ignore
+        }
+        ctx.ui.notify("pi default footer restored", "info");
+      }
+    },
+  });
+}