@heyhuynhgiabuu/pi-pretty

留守终端内部的全面视觉增强扩展:Shiki 语法高亮、树形 ls、内联图片预览、折叠工具输出与内嵌 FFF 检索。

安装命令
pi install npm:@heyhuynhgiabuu/pi-pretty
临时试用 / 替代安装命令
pi -e npm:@heyhuynhgiabuu/pi-pretty
挂接事件钩子与注册入口
session_start / session_shutdownsession_info_changedagent_start / agent_end / agent_settledmessage_update / message_end
内置工具渲染定制(read / bash / ls / find / grep)pi.registerCommand("fff-health" / "fff-rescan")ctx.ui.setWorkingVisible() / setToolsExpanded() / theme / notify()

1. 是什么

@heyhuynhgiabuu/pi-pretty是针对 Pi 默认终端输出的一站式美观与可读性增强扩展。

它还与作者配套的 @heyhuynhgiabuu/pi-diff 协同工作,并直接集成了 @ff-labs/fff-node 接管内置 find / grep 工具。

2. 解决什么问题

原生终端里 read、bash、ls 的输出缺少语法着色、图标层级与折叠收敛,连续调用多次工具后,核心信息很容易被海量纯文本淹没。

3. 作用原理(事件钩子与工具注册层)

覆盖内置工具的渲染外观与默认折叠行为,监听消息与运行状态更新以渲染微光指示条,并维护本地 FFF 文件索引。

  • 在 session_start 为当前工作目录初始化内嵌的 FFF 索引(缓存独立存放在 ~/.pi/agent/pi-pretty/fff/)并接管 find/grep 工具名称。
  • 默认把工具结果体收起为单行标题+行数摘要(保持排版整洁留白),用户可随时用 Pi 快捷键 Ctrl+O 展开单项或 Ctrl+Shift+O 全部展开。
  • 对 read 使用 Shiki 语法高亮加行号(支持在 Ghostty、Kitty、iTerm2、WezTerm 甚至配置了 allow-passthrough 的 tmux 中直接内联显示图片);对 bash 输出带颜色的退出码摘要;对 ls 使用 Nerd Font 图标树形渲染;同时把输入框顶部的 Working… 与思考标签改为渐变微光(shimmer)提示。

4. 怎么装与基本配置

  • 安装命令:pi install npm:@heyhuynhgiabuu/pi-pretty。
  • 重要冲突提示:因为本包内置并接管了 find/grep 的 FFF 实现,开启内嵌 FFF 模式时请勿同时安装加载 @ff-labs/pi-fff。
  • 如在 tmux 中需要看到内联图片,请先开启 tmux set -g allow-passthrough on,并建议使用安装有 Nerd Font 的终端字体。

5. 和同类怎么选

在纯终端美化类扩展中,pi-pretty 覆盖面最全;若只想做“工具折叠”或“只改页脚状态栏”,则有更轻的单点替代。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
pi-tidy pi-tidy 专注把常规工具调用折叠成可点击单行(失败与 diff 保留展开),不接管 FFF 搜索也不做 Shiki/树形 ls 重绘。 已经另行装了 @ff-labs/pi-fff,只想单独解决工具输出刷屏折叠,选 pi-tidy。
pi-starline / @narumitw/pi-statusline 聚焦终端底部页脚状态栏的信息重组,不修改工具正文渲染。 只缺高信息密度状态栏时选它们;想全面美化 read/bash/ls 与加载动画选 @heyhuynhgiabuu/pi-pretty。

同方向对比包与顺序阅读

glimpseui

用系统原生 WebView 替代 Electron 或完整浏览器,为脚本和 Agent 提供可双向 JSON 通信的轻量微 UI 窗口。

阅读该包机制详评

pi-webman

零运行时依赖的 Pi 本地 Web 驾驶舱,为终端里正在运行的会话提供实时 SSE 对话流、遥测仪表盘与命令遥控。

阅读该包机制详评

09 终端 UI 与体验

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「@heyhuynhgiabuu/pi-pretty」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)