$ cat ~/map/pi-statusline.md

pi-statusline

TUI 状态栏：边框标注模型与思考档位，页脚显示 token 流与上下文用量。

extensions✓ 9月3日

pi install npm:@alexeyco/pi-statusline

## 速览

pi TUI 的紧凑状态栏扩展：输入框边框上标注 model • thinking，页脚一行展示 cwd、分支、会话与 ↑in ↓out · ctx%/window 流量，上下文用量按阈值变色。

## 要点

• $输入框上边框右侧标注 `model • thinking`；页脚左侧为 `cwd (branch) • session`，右侧为 `↑in ↓out · ctx%/window`。
• $上下文用量超过 70% 变橙色、超过 90% 变红色；扩展状态（ctx.ui.setStatus）在页脚下方单独占一行。
• $要求 pi 0.76 及以上；peer 依赖为 `*`，由 pi install 解析，扩展安装后自动生效。
• $从本地目录迁移：若之前把扩展放在 ~/.pi/agent/extensions/status-layout/，安装包后请删掉该目录，否则两份副本会同时注册、争抢页脚。
• $开发基于 node:test，需要 Node 22.18 及以上；本地执行 `pi install "$(pwd)"` 可让改动即时生效。

## 常见问题

## 参考链接

• README ↗

最后更新: 2026年9月3日