Pi Web Skill：把 pi 编码智能体会话搬进浏览器的工作台

总结

Pi Web 是 pi coding agent 的本地 Web UI，它把原本只能在终端里翻找的 .jsonl 会话文件，变成可视化的浏览器工作台。这个项目近日登上 GitHub Trending，单日新增 315 颗星，总 star 突破 2500，说明越来越多的开发者不再满足于纯 CLI 与 AI 编码助手交互，而是希望用更接近 IDE 的方式管理会话、切换模型、预览文件和探索历史对话。

功能与原则

Pi Web 的定位非常清晰：不重新发明编码智能体，而是给现有的 pi agent 套一个浏览器外壳。它直接读取 ~/.pi/agent/sessions 下的会话文件，在浏览器里提供项目级会话树、实时聊天窗口、模型配置面板、技能管理器和文件预览器。设计原则是“本地优先、最小侵入”——不需要额外注册账号，也不需要把会话上传到云端，所有数据都留在本地文件系统。

认可度

• GitHub Star：截至 2026-07-24 共 2535 颗星，当日新增 315 星， forks 338，说明正处于快速上升期。
• Trending：2026-07-24 登上 GitHub Trending 当日榜。
• 社区讨论：项目自带中文 README，且 issues 活跃（40 个 open issues），对中文用户较友好。

链接

• GitHub：https://github.com/agegr/pi-web

原作者

项目由 GitHub 用户 agegr 开发并维护，基于 MIT 协议开源。该作者此前已有多个前端/工具链项目，Pi Web 是其面向 AI 编码场景的又一次尝试，强调“给开发者熟悉的浏览器体验”。

介绍

Pi Web 是一个面向 pi coding agent 的本地网页界面。pi agent 本身会把每次会话写入 ~/.pi/agent/sessions/<项目目录>/<时间戳>_<uuid>.jsonl，但这些文件对普通用户并不友好——想要找回某次对话、查看中间产物或切换模型，往往需要在终端里手动 grep、翻目录或改 models.json。Pi Web 把这些操作全部搬到浏览器里，左侧是项目选择器和会话树，右侧是消息区、文件预览和配置面板。

它的核心价值在于“会话可视化”。你可以按项目浏览所有历史 pi 对话，从任意历史消息 fork 出新会话，或者在同一会话内创建分支继续探索，而不会破坏原对话。它还集成了 Git worktree 切换器，让不同分支的会话和文件浏览器自动跟随当前 checkout。对于长时间跑 LLM 的开发者来说，顶部状态栏能直接看到上下文占用、花费、压缩状态和系统提示，让黑箱会话变得可观测。

特点

• 零配置启动：npx @agegr/pi-web@latest 一行命令即可运行，默认监听 http://localhost:30141，服务就绪后自动打开浏览器。
• 会话 fork 与分支：可以从任意历史消息重新开始，也可以复制出独立的新路线，适合并行探索多种实现方案。
• 文件即预览：左侧文件树 + 右侧预览区支持源码、图片、音频、PDF、DOCX，还能自动刷新，边让 agent 改边检查结果。
• 模型与技能管理面板：在网页里就能切换模型、测试 API key、启用或关闭 skills，不用反复编辑终端配置文件。
• 代理友好：读取标准 HTTP_PROXY / HTTPS_PROXY / NO_PROXY 环境变量，适合在公司网络或需要翻墙的场景下使用。

使用方法

1. 确保本地已安装 Node.js 18+。
2. 运行 npx @agegr/pi-web@latest，或全局安装 npm install -g @agegr/pi-web 后执行 pi-web。
3. 浏览器自动打开 http://localhost:30141，左侧选择项目即可看到历史会话。
4. 通过顶部面板切换模型、配置 API key、管理 skills；通过侧边栏切换 Git worktree 或 fork 会话。

最小示例：

npx @agegr/pi-web@latest
# 浏览器打开 http://localhost:30141 即可使用

使用场景与人群

• 重度使用 pi coding agent 的开发者，希望保留完整会话历史并快速回溯。
• 需要并行探索多个实现方向的团队，频繁 fork 和分支会话。
• 对 LLM 花费和上下文长度敏感的用户，希望在 UI 层直接看到压缩状态和 token 消耗。
• 习惯浏览器工作流、不想在终端和文件管理器之间来回切换的工程师。

输入与输出案例

输入：用户在本地已经用 pi agent 完成了若干次编码对话，会话文件散落在 ~/.pi/agent/sessions 不同项目目录下。

输出：打开 Pi Web 后，左侧会话树按项目分组展示所有历史对话；点击任意会话即可查看完整消息、工具调用和结果；点击“Fork”可在新标签页中基于该消息继续对话，原有会话不受影响；顶部状态栏实时显示上下文占用百分比、当前花费和压缩状态，让长会话管理一目了然。

GitHub: https://github.com/agegr/pi-web