pi-webman

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

安装命令
pi install npm:pi-webman
临时试用 / 替代安装命令
pi -e npm:pi-webman
挂接事件钩子与注册入口
session_start / session_shutdown / session_info_changedagent_start / agent_end / agent_settledturn_start / turn_endmessage_start / message_update / message_endtool_execution_start / tool_execution_update / tool_execution_endmodel_select / thinking_level_selectsession_before_compact / session_compact / session_compact_failedsession_tree / ui_prompt_start / ui_prompt_end
pi.registerCommand("/web" / "/webman" / "/web-session")pi.registerFlag("--web" / "--web-port" / "--web-host" / "--web-token" / "--web-open")ctx.ui.setStatus() / notify()(页脚显示 ◈ WEB :4747)

1. 是什么

pi-webman(Pi // Cockpit)是 steelburn 开发的零第三方依赖本地 Web UI 扩展。

它在你终端正常跑 Pi 时同步开启本地 HTTP + SSE 服务(默认 127.0.0.1:4747),把会话实时镜像并遥控到浏览器里。

2. 解决什么问题

在多步骤复杂任务中,纯终端屏幕很难同时看清上下文压力环、缓存 token、费用流速、完整推理过程、各工具耗时及彩色 diff,也不方便在大量工具和模型间快速检索切换。

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

仅用 Node 内置模块启动本地 Web 服务,订阅全量 Pi 生命周期事件并通过 Server-Sent Events(SSE)实时推送到前端驾驶舱,同时双向桥接控制与弹窗。

  • 通过 /web(或启动参数 —web)拉起本地 Web 服务;页面打开或断线重连时先拉取完整会话快照,随后通过 SSE 持续接收助手文本、隐藏推理块与工具卡片(含输入、输出、耗时和彩色 diff)。
  • 页面顶部与遥测区实时汇总上下文容量环、输入/输出/缓存 token、推理 token、预估费用、吞吐速率和任务计时。
  • 控制面支持直接从浏览器发送、steer 或 follow-up 消息、中断运行、切换模型/thinking 级别、压缩上下文以及 Ctrl/Cmd+K 命令面板;同时具备弹窗桥接(Extension popups),可以把其他扩展在终端弹出的交互转发到浏览器模态框完成。

4. 怎么装与基本配置

  • 运行 pi install npm:pi-webman 安装,进入 Pi 后执行 /web open 即可启动服务并打开浏览器。
  • 如要通过非本机环回接口(—web-host)访问,务必配置 —web-token 或环境变量 PI_COCKPIT_TOKEN 启用认证。
  • 支持在 /reload 后自动恢复驾驶舱服务,无需重新手动打开。

5. 和同类怎么选

在终端 UI 与体验方向里,pi-webman 主打“浏览器零依赖大屏驾驶舱”;glimpseui 主打“轻量原生 OS 微窗口”;pi-pretty 则留在纯终端内部升级渲染。

与同类方案的选型对照

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

对比对象 机制差异 怎么选
glimpseui glimpseui 定位为可编程的原生系统 WebView 弹窗引擎,用来给脚本或扩展画自定义小窗口或悬浮指示器,有别于完整的会话驾驶舱。 想要现成的会话监控与遥控网页选 pi-webman;自己写扩展或脚本需要弹出原生小组件选 glimpseui。
pi-studio(方向 05) pi-studio 偏向双栏浏览器工作区、主动测验与 tmux REPL;pi-webman 偏向随终端会话伴生的遥测 HUD 与实时控制面板。 主力仍留在终端编码、把浏览器当作副屏仪表盘时选 pi-webman。

同方向对比包与顺序阅读

glimpseui

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

阅读该包机制详评

@heyhuynhgiabuu/pi-pretty

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

阅读该包机制详评

09 终端 UI 与体验

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

返回方向总论页

看完「pi-webman」后的下一步

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

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

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

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

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

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

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