pi-tidy-footer 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,121 @@
+# Changelog
+
+[中文](#中文)
+
+## [0.4.0] - 2026-07-22
+
+### Added
+
+- `/se` command: show or set extension status sort order, persisted across sessions
+- Extension statuses now sorted by user-defined order instead of alphabetically; unlisted extensions appear at the end
+
+### Changed
+
+- Ponytail and Caveman status formatting switched from regex reconstruction to replace-based approach, preserving native colours
+- Ponytail status: removed ⚡ emoji, level text lowercased, 🐴 emoji kept
+- Caveman status: label capitalised to `Caveman:`, level text lowercased
+
+### Fixed
+
+- `writePersistedEnabled` no longer overwrites other state keys (balance thresholds, extension order)
+- Duplicate `clearTimeout` call in `dispose()` removed
+- Unreachable fallback in `formatToolActivity` removed
+- `!== null` → `!= null` in context usage check (handles undefined correctly)
+- `fetchBalance` for DeepSeek: added null guard before `parseFloat` to avoid implicit exception handling
+- Removed redundant `existsSync` calls in `readPersistedEnabled` and `readExtensionOrder`
+
+## [0.3.0] — 2026-07-19
+
+### Added
+
+- Account balance after the model name on line 2 (`¤¥` format, DeepSeek and Kimi), auto-refreshed after each turn (30s cooldown); yellow under warn threshold, red under alert threshold
+- `/bt <warn> <alert>` command to set custom yellow/red balance thresholds, persisted, warn > alert required
+
+### Changed
+
+- Tool activity indicator simplified to show only the running tool with a brief hold for fast tools; removed thinking and completed states
+- README: repositioned cost removal as "from the left stats area, keeping it token-focused"; added "Tweaks to other extensions" section
+
+## [0.2.0] — 2026-07-19
+
+### Added
+
+- Git status tokens next to the branch name on line 1: `⇡` ahead, `⇣` behind, `+` staged, `~` modified, `?` untracked, `!` conflicts; hidden when clean; fetched asynchronously (250ms debounce + 30s polling + refresh after tool execution)
+- Tool activity indicator before the model name on line 2: running tool, streaming (thinking), last completed tool; hidden when idle
+- Colored indicator: accent while running, success when completed, dim while thinking
+
+### Fixed
+
+- Thinking level stuck at `off`: now reads the latest `thinking_level_change` session entry, correctly following Shift+Tab (same data source as the built-in footer)
+- MCP extension status color: preserves the original accent color with a dimmed `MCP:` label, no longer loses color on theme changes
+- `/tf` command description corrected to "Toggle pi-tidy-footer on / off"; unified to standard hyphens in UI text
+
+## [0.1.0] — 2026-07-18
+
+### Added
+
+- First release
+- `/tf` command to toggle footer without cost ($)
+- Persistent toggle state across sessions
+- Preserves all other built-in footer info
+
+---
+
+## 中文
+
+## [0.4.0] - 2026-07-22
+
+### 新增
+
+- `/se` 命令：查看或设置扩展状态排序，持久化存储
+- 扩展状态按用户自定义顺序排列，未列出的扩展自动排至末尾
+
+### 变更
+
+- Ponytail 和 Caveman 状态格式化从正则重组改为 replace 方式，保留原生颜色
+- Ponytail 状态：移除 ⚡ 符号，级别字母全小写，🐴 符号保留
+- Caveman 状态：标签首字母大写为 `Caveman:`，级别字母全小写
+
+### 修复
+
+- `writePersistedEnabled` 不再覆盖其他状态键（余额阈值、扩展顺序）
+- 删除 `dispose()` 中的重复 `clearTimeout` 调用
+- 删除 `formatToolActivity` 中不可达的兜底逻辑
+- 上下文用量检查 `!== null` → `!= null`（正确处置 undefined）
+- DeepSeek 余额查询：`parseFloat` 前添加空值保护，避免隐式依赖异常流
+- 删除 `readPersistedEnabled` 和 `readExtensionOrder` 中的冗余 `existsSync` 调用
+
+## [0.3.0] — 2026-07-19
+
+### 新增
+
+- 第 2 行模型名后显示当前 provider 的账户余额（`¤¥` 格式，支持 DeepSeek 和 Kimi），每个 turn 结束后自动刷新（30s 冷却）；余额低于警告线变黄、低于红线变红
+- `/bt <warn> <alert>` 命令：自定义余额黄/红阈值，持久化存储，warn 必须大于 alert
+
+### 变更
+
+- 工具活动指示精简为仅显示运行中的工具，快工具至少保留 150ms 驻留；移除 thinking 和已完成状态
+- README：去除费用表述改为"从左侧统计模块移除 $0.604，让统计专注 token"；新增"其他扩展微调"小节
+
+## [0.2.0] — 2026-07-19
+
+### 新增
+
+- 第 1 行分支名旁显示 Git 状态标记：`⇡` 领先、`⇣` 落后、`+` 已暂存、`~` 已修改、`?` 未跟踪、`!` 冲突；干净仓库不显示；异步获取（250ms 防抖 + 30s 轮询 + 工具结束后刷新）
+- 第 2 行模型名前显示工具活动指示：运行中工具、流式生成、刚完成的工具；空闲时不显示
+- 工具指示着色：运行中 accent、刚完成 success、thinking dim
+
+### 修复
+
+- thinking level 始终显示 off：改为从会话条目中获取最近一次的 `thinking_level_change`，正确跟随 Shift+Tab（数据源与内置页脚等价）
+- MCP 扩展状态颜色：保留原始强调色值，`MCP:` 前缀置灰，主题切换不再丢色
+- `/tf` 命令描述修正为 "Toggle pi-tidy-footer on / off"；文案统一使用普通连字符
+
+## [0.1.0] — 2026-07-18
+
+### 新增
+
+- 首个正式版本
+- `/tf` 命令切换页脚，去除费用 ($) 显示
+- 切换状态跨会话持久化
+- 保留内置页脚全部其他信息

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 eriiic7z
+
+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,71 @@
+# pi-tidy-footer
+
+[中文](#中文)
+
+Tidy footer for Pi coding agent — native layout, layered with new features: extension sort order, token balance display (color-coded warnings with configurable thresholds), git status tokens, and tool activity indicators; minor display tweaks for selected third-party extensions, keeping it clean.
+
+## Install
+
+```bash
+pi install npm:pi-tidy-footer
+```
+
+## Features
+
+- **Account balance** — Shows DeepSeek or Kimi account balance after the model name (`¤¥` format), yellow below warn threshold, red below alert threshold, both configurable
+- **Extension sort order** — Custom sort order for extension statuses, persisted across sessions; run empty command to view the current order prompt
+- **Git status tokens** — Repo state next to the branch name: `⇡` ahead, `⇣` behind, `+` staged, `~` modified, `?` untracked, `!` conflicts; hidden when clean
+- **Tool activity indicator** — Shows the running tool (highlighted) before the model name with brief hold for fast tools; hidden when idle
+- **Hide per-session cost** — Removes `$0.604` from the left stats area, keeping it token-focused
+- **Toggle & persistence** — `/tf` toggles back to the original footer anytime; all settings survive restarts
+- **Mostly native** — Everything else (model, token stats, context %, git branch) kept intact
+
+## Display tweaks for other extensions
+
+- **pi-mcp-adapter** — Dimmed the `MCP:` label while preserving its original accent color, keeping the status line visually coherent across theme changes
+- **ponytail** — Removed ⚡ emoji from status, level text lowercased, 🐴 emoji kept
+- **caveman** — Label capitalised to `Caveman:`, level text lowercased
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `/tf` | Toggle pi-tidy-footer (on/off) |
+| `/bt <warn> <alert>` | Set balance yellow/red thresholds (warn > alert required) |
+| `/se` | Show or set extension status sort order |
+
+---
+
+## 中文
+
+为 Pi coding agent 打造的整洁页脚 — 沿用原生布局，叠加了新的功能：插件自定义排序、token 余额显示（颜色警告、自定义警告阈值）、Git 状态标记、工具活动指示；对部分第三方插件进行名称显示微调，保持简洁。
+
+## 安装
+
+```bash
+pi install npm:pi-tidy-footer
+```
+
+## 功能
+
+- **账户余额** — 模型名后显示 DeepSeek / Kimi 账户余额（`¤¥` 格式），低于预警值（warn）变黄，低于警报值（alert）变红，阈值可自定义
+- **插件自定义排序** — 扩展状态按自定义顺序排列，持久化存储；可使用空命令查看排序字段提示
+- **Git 状态标记** — 分支名旁显示仓库状态：`⇡` 领先、`⇣` 落后、`+` 已暂存、`~` 已修改、`?` 未跟踪、`!` 冲突；干净仓库不显示
+- **工具活动指示** — 模型名前实时显示正在运行的工具（高亮），快工具至少有短暂停留；空闲时不显示
+- **去除会话费用显示** — 从左侧统计模块移除 `$0.604`，让统计专注 token
+- **开关与持久化** — `/tf` 随时切回原始页脚；所有设置重启后保持不变
+- **基本保留原生样式** — 其余所有内置页脚信息（模型、Token 统计、上下文百分比、Git 分支）保持不变
+
+## 其他扩展的显示微调
+
+- **pi-mcp-adapter** — `MCP:` 标签置灰、保留原始强调色值，使状态行在不同主题下保持视觉协调
+- **ponytail** — 状态中移除 ⚡ 符号，级别字母全小写，🐴 符号保留
+- **caveman** — 标签首字母大写为 `Caveman:`，级别字母全小写
+
+## 命令
+
+| 命令 | 说明 |
+| --- | --- |
+| `/tf` | 切换 pi-tidy-footer 页脚（开/关） |
+| `/bt <warn> <alert>` | 设置余额黄/红阈值（warn > alert） |
+| `/se` | 查看或设置扩展状态排列顺序 |

package/extensions/pi-tidy-footer.ts

@@ -0,0 +1,735 @@
+/**
+ * pi-tidy-footer — removes cost ($) from the built-in Pi footer.
+ * Toggle with /tf. State persists across restarts.
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+
+const AUTH_PATH = join(homedir(), ".pi", "agent", "auth.json");
+
+/* ------------------------------------------------------------------ */
+/*  persistence                                                        */
+/* ------------------------------------------------------------------ */
+
+const STATE_DIR = join(homedir(), ".pi", "agent", "extensions");
+const STATE_FILE = join(STATE_DIR, "pi-tidy-footer-state.json");
+
+function readPersistedEnabled(): boolean {
+	try {
+		return JSON.parse(readFileSync(STATE_FILE, "utf-8")).enabled === true;
+	} catch {
+		return false;
+	}
+}
+
+function readThresholds(): { warn: number; alert: number } {
+	try {
+		const raw = JSON.parse(readFileSync(STATE_FILE, "utf-8"));
+		let w = Number(raw?.balanceThresholdWarn);
+		let a = Number(raw?.balanceThresholdAlert);
+		if (!Number.isFinite(w) || !Number.isFinite(a) || w <= a) {
+			w = 30;
+			a = 10;
+		}
+		return { warn: w, alert: a };
+	} catch {
+		return { warn: 30, alert: 10 };
+	}
+}
+
+function writeThresholds(warn: number, alert: number): void {
+	try {
+		const prev: any = existsSync(STATE_FILE)
+			? JSON.parse(readFileSync(STATE_FILE, "utf-8"))
+			: {};
+		mkdirSync(STATE_DIR, { recursive: true });
+		writeFileSync(
+			STATE_FILE,
+			JSON.stringify({
+				...prev,
+				balanceThresholdWarn: warn,
+				balanceThresholdAlert: alert,
+			}),
+			"utf-8",
+		);
+	} catch {
+		/* no-op */
+	}
+}
+
+function writePersistedEnabled(enabled: boolean): void {
+	try {
+		const prev: any = existsSync(STATE_FILE)
+			? JSON.parse(readFileSync(STATE_FILE, "utf-8"))
+			: {};
+		mkdirSync(STATE_DIR, { recursive: true });
+		writeFileSync(STATE_FILE, JSON.stringify({ ...prev, enabled }), "utf-8");
+	} catch {
+		/* no-op */
+	}
+}
+
+function readExtensionOrder(): string[] {
+	const fallback = ["caveman", "ponytail", "mcp", "pi-lens-lsp"];
+	try {
+		const raw = JSON.parse(readFileSync(STATE_FILE, "utf-8"));
+		return Array.isArray(raw?.extensionOrder) ? raw.extensionOrder : fallback;
+	} catch {
+		return fallback;
+	}
+}
+
+function writeExtensionOrder(order: string[]): void {
+	try {
+		const prev: any = existsSync(STATE_FILE)
+			? JSON.parse(readFileSync(STATE_FILE, "utf-8"))
+			: {};
+		mkdirSync(STATE_DIR, { recursive: true });
+		writeFileSync(
+			STATE_FILE,
+			JSON.stringify({ ...prev, extensionOrder: order }),
+			"utf-8",
+		);
+	} catch {
+		/* no-op */
+	}
+}
+
+function getApiKey(provider: string): string | undefined {
+	try {
+		return (JSON.parse(readFileSync(AUTH_PATH, "utf-8")) as any)[provider]?.key;
+	} catch {
+		return undefined;
+	}
+}
+
+async function fetchBalance(
+	provider: string,
+	key: string,
+): Promise<string | undefined> {
+	const url =
+		provider === "deepseek"
+			? "https://api.deepseek.com/user/balance"
+			: provider === "moonshotai-cn"
+				? "https://api.moonshot.cn/v1/users/me/balance"
+				: null;
+	if (!url) return undefined;
+	const resp = await fetch(url, {
+		headers: { Authorization: `Bearer ${key}` },
+	});
+	if (!resp.ok) return undefined;
+	const data = (await resp.json()) as any;
+	if (provider === "deepseek") {
+		const v = data?.balance_infos?.[0]?.total_balance;
+		return v != null ? parseFloat(v).toFixed(2) : undefined;
+	}
+	if (provider === "moonshotai-cn") {
+		const bal = data?.data;
+		const cash = Number.parseFloat(bal?.cash_balance ?? "");
+		const voucher = Number.parseFloat(bal?.voucher_balance ?? "");
+		const available = Number.parseFloat(bal?.available_balance ?? "");
+		const raw =
+			Number.isNaN(cash) || Number.isNaN(voucher)
+				? Number.isNaN(available)
+					? undefined
+					: available
+				: cash + voucher;
+		return raw === undefined ? undefined : raw.toFixed(2);
+	}
+	return undefined;
+}
+
+/* ------------------------------------------------------------------ */
+/*  helpers                                                            */
+/* ------------------------------------------------------------------ */
+
+function fmtTok(n: number): string {
+	if (n < 1000) return `${n}`;
+	if (n < 10000) return `${(n / 1000).toFixed(1)}k`;
+	if (n < 1_000_000) return `${Math.round(n / 1000)}k`;
+	return `${(n / 1_000_000).toFixed(1)}M`;
+}
+
+function fmtCwd(cwd: string, home: string | undefined): string {
+	if (!home) return cwd;
+	const rc = resolve(cwd);
+	const rh = resolve(home);
+	const rel = relative(rh, rc);
+	if (
+		rel === "" ||
+		(rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel))
+	)
+		return rel === "" ? "~" : `~${sep}${rel}`;
+	return cwd;
+}
+
+/* ------------------------------------------------------------------ */
+/*  git status tokens (feature ported from pi-statusline, plain style) */
+/* ------------------------------------------------------------------ */
+
+function parseGitStatusTokens(stdout: string): string {
+	let ahead = 0,
+		behind = 0,
+		staged = 0,
+		modified = 0,
+		untracked = 0,
+		conflicts = 0;
+	for (const line of stdout.split("\n")) {
+		if (!line) continue;
+		if (line.startsWith("## ")) {
+			const a = line.match(/\bahead (\d+)/);
+			const b = line.match(/\bbehind (\d+)/);
+			ahead = a ? Number(a[1]) : 0;
+			behind = b ? Number(b[1]) : 0;
+			continue;
+		}
+		const x = line[0] ?? " ";
+		const y = line[1] ?? " ";
+		if (x === "?" && y === "?") {
+			untracked++;
+			continue;
+		}
+		if (
+			(x === "D" && y === "D") ||
+			(x === "A" && y === "A") ||
+			x === "U" ||
+			y === "U"
+		) {
+			conflicts++;
+			continue;
+		}
+		if (x !== " " && x !== "?" && x !== "!") staged++;
+		if (y !== " " && y !== "?" && y !== "!") modified++;
+	}
+	const parts: string[] = [];
+	if (ahead) parts.push(`⇡${ahead}`);
+	if (behind) parts.push(`⇣${behind}`);
+	if (staged) parts.push(`+${staged}`);
+	if (modified) parts.push(`~${modified}`);
+	if (untracked) parts.push(`?${untracked}`);
+	if (conflicts) parts.push(`!${conflicts}`);
+	return parts.join(" ");
+}
+
+/* ------------------------------------------------------------------ */
+/*  tool activity                                                      */
+/* ------------------------------------------------------------------ */
+
+interface ToolActivityState {
+	active: Map<string, number>;
+	minDisplayQueue: string[];
+	minDisplayTimer: ReturnType<typeof setTimeout> | undefined;
+}
+
+interface LiveHooks {
+	requestRender: (() => void) | undefined;
+	refreshGit: (() => void) | undefined;
+	refreshBalance: (() => void) | undefined;
+}
+
+function formatToolActivity(state: ToolActivityState): string {
+	const active = [...state.active.entries()];
+	if (active.length > 0) {
+		const [name, count] = active[0];
+		const suffix =
+			count > 1
+				? `×${count}`
+				: active.length > 1
+					? `+${active.length - 1}`
+					: "";
+		return `⚙ ${name}${suffix}`;
+	}
+	return "";
+}
+
+/* ------------------------------------------------------------------ */
+/*  footer factory                                                     */
+/* ------------------------------------------------------------------ */
+
+function makeFooter(
+	ctx: any,
+	tui: any,
+	theme: any,
+	fd: any,
+	toolState: ToolActivityState,
+	live: LiveHooks,
+	thresholds: { warn: number; alert: number },
+	extensionOrder: string[],
+) {
+	let disposed = false;
+	let gitTokens = "";
+	let gitInFlight = false;
+	let gitQueued = false;
+	let gitDebounce: ReturnType<typeof setTimeout> | undefined;
+	let balanceText = "";
+	let balanceProvider = "";
+	let balanceStale = false;
+	let balanceLastFetch = 0;
+	let balanceInFlight = false;
+
+	const runGitStatus = () => {
+		if (disposed) return;
+		if (gitInFlight) {
+			gitQueued = true;
+			return;
+		}
+		gitInFlight = true;
+		void (async () => {
+			try {
+				const result = await ctx.exec(
+					"git",
+					[
+						"--no-optional-locks",
+						"status",
+						"--porcelain=v1",
+						"--branch",
+						"--untracked-files=normal",
+					],
+					{ cwd: ctx.sessionManager.getCwd(), timeout: 3000 },
+				);
+				gitTokens =
+					result.code === 0 && !result.killed
+						? parseGitStatusTokens(result.stdout)
+						: "";
+			} catch {
+				gitTokens = "";
+			} finally {
+				gitInFlight = false;
+				if (!disposed) tui.requestRender();
+				if (gitQueued) {
+					gitQueued = false;
+					runGitStatus();
+				}
+			}
+		})();
+	};
+
+	const refreshGit = () => {
+		if (disposed) return;
+		if (gitDebounce) clearTimeout(gitDebounce);
+		gitDebounce = setTimeout(() => {
+			gitDebounce = undefined;
+			runGitStatus();
+		}, 250);
+	};
+
+	const unsub = fd.onBranchChange(() => {
+		gitTokens = "";
+		refreshGit();
+		tui.requestRender();
+	});
+	const gitInterval = setInterval(runGitStatus, 30000);
+	live.requestRender = () => tui.requestRender();
+	live.refreshGit = refreshGit;
+	runGitStatus();
+
+	const runBalance = () => {
+		if (disposed) return;
+		const provider = ctx.model?.provider;
+		if (provider !== "deepseek" && provider !== "moonshotai-cn") {
+			balanceText = "";
+			balanceProvider = "";
+			balanceStale = false;
+			tui.requestRender();
+			return;
+		}
+		const now = Date.now();
+		if (
+			balanceLastFetch > 0 &&
+			now - balanceLastFetch < 30_000 &&
+			balanceProvider === provider
+		) {
+			// still fresh
+			return;
+		}
+		balanceProvider = provider;
+		balanceLastFetch = now;
+		if (balanceInFlight) return;
+		const key = getApiKey(provider);
+		if (!key) return;
+		balanceInFlight = true;
+		void (async () => {
+			try {
+				const value = await fetchBalance(provider, key);
+				if (disposed || ctx.model?.provider !== provider) {
+					balanceText = "";
+					balanceProvider = "";
+				} else if (value !== undefined) {
+					balanceText = `¤¥${value}`;
+					balanceStale = false;
+				} else {
+					balanceText = "";
+					balanceProvider = "";
+				}
+			} catch {
+				if (!disposed && ctx.model?.provider === provider) {
+					if (balanceText) balanceStale = true;
+					else {
+						balanceText = "";
+						balanceProvider = "";
+					}
+				}
+			} finally {
+				balanceInFlight = false;
+				if (!disposed) tui.requestRender();
+			}
+		})();
+	};
+	live.refreshBalance = runBalance;
+	if (!balanceText) runBalance();
+
+	return {
+		dispose() {
+			disposed = true;
+			unsub();
+			clearInterval(gitInterval);
+			if (gitDebounce) clearTimeout(gitDebounce);
+			live.requestRender = undefined;
+			live.refreshGit = undefined;
+			live.refreshBalance = undefined;
+		},
+		render(width: number): string[] {
+			const session = ctx.sessionManager;
+			/* token stats — cost intentionally omitted */
+			let inp = 0,
+				out = 0,
+				cr = 0,
+				cw = 0;
+			let hitRate: number | undefined;
+			for (const e of session.getBranch()) {
+				if (e.type === "message" && e.message.role === "assistant") {
+					const msg = e.message as AssistantMessage;
+					inp += msg.usage.input;
+					out += msg.usage.output;
+					cr += msg.usage.cacheRead;
+					cw += msg.usage.cacheWrite;
+					const prompt =
+						msg.usage.input + msg.usage.cacheRead + msg.usage.cacheWrite;
+					hitRate =
+						prompt > 0 ? (msg.usage.cacheRead / prompt) * 100 : undefined;
+				}
+			}
+
+			/* context usage */
+			const cu = ctx.getContextUsage();
+			const ctxWin = cu?.contextWindow ?? ctx.model?.contextWindow ?? 0;
+			const pct = cu?.percent ?? 0;
+			const pctStr = cu?.percent != null ? pct.toFixed(1) : "?";
+
+			/* pwd / git */
+			let pwd = fmtCwd(
+				session.getCwd(),
+				process.env.HOME || process.env.USERPROFILE,
+			);
+			const gitBranch = fd.getGitBranch();
+			if (gitBranch)
+				pwd = gitTokens
+					? `${pwd} (${gitBranch} ${gitTokens})`
+					: `${pwd} (${gitBranch})`;
+			const sname = session.getSessionName();
+			if (sname) pwd = `${pwd} • ${sname}`;
+
+			/* stats line */
+			const parts: string[] = [];
+			if (inp) parts.push(`↑${fmtTok(inp)}`);
+			if (out) parts.push(`↓${fmtTok(out)}`);
+			if (cr) parts.push(`R${fmtTok(cr)}`);
+			if (cw) parts.push(`W${fmtTok(cw)}`);
+			if ((cr || cw) && hitRate !== undefined)
+				parts.push(`CH${hitRate.toFixed(1)}%`);
+			const ctxPctDisp =
+				pctStr === "?" ? `?/${fmtTok(ctxWin)}` : `${pctStr}%/${fmtTok(ctxWin)}`;
+			let ctxPctStr: string;
+			if (pct > 90) ctxPctStr = theme.fg("error", ctxPctDisp);
+			else if (pct > 70) ctxPctStr = theme.fg("warning", ctxPctDisp);
+			else ctxPctStr = ctxPctDisp;
+			parts.push(ctxPctStr);
+
+			let left = parts.join(" ");
+			let lw = visibleWidth(left);
+			if (lw > width) left = truncateToWidth(left, width, "...");
+			lw = visibleWidth(left);
+
+			/* model / thinking — get thinking level from session entries (mirrors native footer) */
+			const mName = ctx.model?.id || "no-model";
+			let right = mName;
+			if (ctx.model?.reasoning) {
+				let tl = "off";
+				// Walk session branch backwards for most recent thinking_level_change
+				const branch = session.getBranch();
+				for (let i = branch.length - 1; i >= 0; i--) {
+					const e = branch[i];
+					if (e.type === "thinking_level_change") {
+						tl = (e as any).thinkingLevel || "off";
+						break;
+					}
+				}
+				right = tl === "off" ? `${mName} • thinking off` : `${mName} • ${tl}`;
+			}
+			const toolText = formatToolActivity(toolState);
+			const toolColor = "accent";
+			const toolSeg = toolText ? `${theme.fg(toolColor, toolText)}  ` : "";
+			const balanceTextVal = balanceText;
+			const balanceProviderVal = ctx.model?.provider;
+			let balanceSeg = "";
+			if (balanceTextVal && balanceProviderVal === balanceProvider) {
+				const num = Number.parseFloat(balanceTextVal.slice(2));
+				const color = Number.isNaN(num)
+					? "dim"
+					: num < thresholds.alert
+						? "error"
+						: num < thresholds.warn
+							? "warning"
+							: "dim";
+				balanceSeg = `  ${theme.fg(color, balanceTextVal + (balanceStale ? "?" : ""))}`;
+			}
+			const rw =
+				visibleWidth(right) +
+				(toolText ? visibleWidth(toolText) + 2 : 0) +
+				visibleWidth(balanceSeg);
+
+			const pad = width - lw - rw;
+			let line2: string;
+			if (pad >= 0) {
+				line2 =
+					theme.fg("dim", left) +
+					" ".repeat(pad) +
+					toolSeg +
+					theme.fg("dim", right) +
+					balanceSeg;
+			} else if (width - lw - 2 > 0) {
+				line2 =
+					theme.fg("dim", left) +
+					theme.fg(
+						"dim",
+						"  " +
+							truncateToWidth(
+								(toolText ? `${toolText}  ` : "") + right + balanceSeg,
+								width - lw - 2,
+								"",
+							),
+					);
+			} else {
+				line2 = theme.fg("dim", left);
+			}
+
+			/* extension statuses */
+			const extItems: string[] = [];
+			const raw = fd.getExtensionStatuses();
+			let mcpRgb = ""; // capture original MCP accent colour so theme changes work
+			if (raw.size > 0) {
+				const order = new Map<string, number>();
+				extensionOrder.forEach((key, i) => order.set(key, i));
+				const sorted = (Array.from(raw.entries()) as [string, string][])
+					.sort(([a], [b]) => {
+						const oa = order.get(a) ?? 99;
+						const ob = order.get(b) ?? 99;
+						return oa !== ob ? oa - ob : a.localeCompare(b);
+					})
+					.map(([k, v]) => {
+						if (k === "caveman") {
+							const s = (v as string)
+								.replace("caveman level:", "Caveman:")
+								.replace(/(FULL|ULTRA|LITE|OFF)/g, (w) => w.toLowerCase());
+							return s;
+						}
+						if (k === "ponytail") {
+							const s = (v as string)
+								.replace("⚡ ", "")
+								.replace(/(FULL|ULTRA|LITE|OFF)/g, (w) => w.toLowerCase())
+								.replace(
+									" 🐴 \x1b[38;2;128;128;128mponytail:",
+									" 🐴\x1b[38;2;128;128;128mponytail:",
+								);
+							return s;
+						}
+						return (v as string).trim();
+					})
+					.filter(Boolean);
+				extItems.push(...sorted);
+			}
+
+			// Extract original MCP accent RGB from the raw text before we strip colours
+			const rawMcp = raw.get("mcp");
+			if (rawMcp) {
+				const m = (rawMcp as string).match(/\x1b\[38;2;(\d+);(\d+);(\d+)m/);
+				if (m) mcpRgb = `\x1b[38;2;${m[1]};${m[2]};${m[3]}m`;
+			}
+
+			const lines: string[] = [
+				truncateToWidth(theme.fg("dim", pwd), width, theme.fg("dim", "...")),
+				line2,
+			];
+			if (extItems.length > 0) {
+				let statusLine = extItems.join(" ");
+				// Rewrite MCP: prefix with dim colour, reset after the colon
+				statusLine = statusLine.replace(
+					/MCP:/,
+					`\x1b[38;2;128;128;128mMCP:${mcpRgb || "\x1b[38;2;138;190;183m"}`,
+				);
+				lines.push(truncateToWidth(statusLine, width, theme.fg("dim", "...")));
+			}
+
+			return lines;
+		},
+	};
+}
+
+/* ------------------------------------------------------------------ */
+/*  extension entry-point                                              */
+/* ------------------------------------------------------------------ */
+
+export default function (pi: any) {
+	const toolState: ToolActivityState = {
+		active: new Map(),
+		minDisplayQueue: [],
+		minDisplayTimer: undefined,
+	};
+	const live: LiveHooks = {
+		requestRender: undefined,
+		refreshGit: undefined,
+		refreshBalance: undefined,
+	};
+
+	function applyFooter(ctx: any) {
+		const thresholds = readThresholds();
+		const extensionOrder = readExtensionOrder();
+		ctx.ui.setFooter((tui: any, theme: any, fd: any) =>
+			makeFooter(
+				ctx,
+				tui,
+				theme,
+				fd,
+				toolState,
+				live,
+				thresholds,
+				extensionOrder,
+			),
+		);
+	}
+
+	let enabled = readPersistedEnabled();
+
+	pi.on("session_start", async (_event: any, ctx: any) => {
+		enabled = readPersistedEnabled();
+		toolState.active.clear();
+		toolState.minDisplayQueue.length = 0;
+		if (toolState.minDisplayTimer) clearTimeout(toolState.minDisplayTimer);
+		toolState.minDisplayTimer = undefined;
+		if (enabled) applyFooter(ctx);
+	});
+
+	pi.on("tool_execution_start", (event: any) => {
+		toolState.active.set(
+			event.toolName,
+			(toolState.active.get(event.toolName) ?? 0) + 1,
+		);
+		live.requestRender?.();
+	});
+
+	pi.on("tool_execution_end", (event: any) => {
+		const n = toolState.active.get(event.toolName) ?? 0;
+		if (n <= 1) toolState.active.delete(event.toolName);
+		else toolState.active.set(event.toolName, n - 1);
+		// minimum 150ms display so fast tools don't flicker
+		if (!toolState.active.has(event.toolName)) {
+			toolState.minDisplayQueue.push(event.toolName);
+			if (!toolState.minDisplayTimer) {
+				toolState.minDisplayTimer = setTimeout(() => {
+					toolState.minDisplayQueue = [];
+					toolState.minDisplayTimer = undefined;
+					live.requestRender?.();
+				}, 150);
+			}
+		} else {
+			toolState.minDisplayQueue = toolState.minDisplayQueue.filter(
+				(q) => q !== event.toolName,
+			);
+		}
+		live.requestRender?.();
+		live.refreshGit?.();
+	});
+
+	pi.on("agent_start", () => {
+		live.requestRender?.();
+	});
+
+	pi.on("agent_end", () => {
+		live.requestRender?.();
+		live.refreshGit?.();
+	});
+
+	pi.on("model_select", () => {
+		live.refreshBalance?.();
+	});
+
+	pi.on("turn_end", () => {
+		live.refreshBalance?.();
+	});
+
+	pi.registerCommand("bt", {
+		description:
+			"Set balance thresholds: warn (yellow) / alert (red), warn > alert",
+		handler: async (args: string, ctx: any) => {
+			const parts = args.trim().split(/\s+/);
+			const warn = Number(parts[0]);
+			const alert = Number(parts[1]);
+			if (
+				parts.length !== 2 ||
+				!Number.isFinite(warn) ||
+				!Number.isFinite(alert) ||
+				warn <= alert
+			) {
+				ctx.ui.notify(
+					"Usage: /bt <warn> <alert> (warn > alert). Default: 30 10",
+					"error",
+				);
+				return;
+			}
+			writeThresholds(warn, alert);
+			// re-apply footer with fresh thresholds
+			if (enabled) applyFooter(ctx);
+			ctx.ui.notify(
+				`Balance thresholds: yellow < ${warn}, red < ${alert}`,
+				"info",
+			);
+		},
+	});
+
+	pi.registerCommand("tf", {
+		description: "Toggle pi-tidy-footer on / off",
+		handler: async (_args: string, ctx: any) => {
+			enabled = !enabled;
+			writePersistedEnabled(enabled);
+
+			if (enabled) {
+				applyFooter(ctx);
+				ctx.ui.notify("Cost-free footer ON", "info");
+			} else {
+				ctx.ui.setFooter(undefined);
+				ctx.ui.notify("Default footer restored", "info");
+			}
+		},
+	});
+
+	pi.registerCommand("se", {
+		description:
+			"Sort extension statuses (no args = show order, keys = set order)",
+		handler: async (args: string, ctx: any) => {
+			const trimmed = args.trim();
+			if (!trimmed) {
+				const current = readExtensionOrder();
+				ctx.ui.notify(`Extension order: ${current.join(" ")}`, "info");
+				return;
+			}
+			const keys = trimmed.split(/\s+/);
+			writeExtensionOrder(keys);
+			if (enabled) applyFooter(ctx);
+			ctx.ui.notify(`Extension order: ${keys.join(" ")}`, "info");
+		},
+	});
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "pi-tidy-footer",
+  "version": "0.4.0",
+  "description": "Tidy footer for Pi coding agent — native layout, layered with new features: extension sort order, token balance display (color-coded warnings with configurable thresholds), git status tokens, and tool activity indicators; minor display tweaks for selected third-party extensions, keeping it clean.",
+  "type": "module",
+  "main": "extensions/pi-tidy-footer.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eriiic7z/pi-tidy-footer.git"
+  },
+  "files": [
+    "extensions",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions/pi-tidy-footer.ts"
+    ]
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "extension"
+  ],
+  "author": "eriiic7z",
+  "devDependencies": {
+    "@types/node": "^26.1.1"
+  }
+}