$ cat ~/map/pi.md

pi

Pi 官方单仓库：统一 LLM API、agent 循环、终端界面与编程 agent CLI 本体。

officialtools✓ 10月16日

事实速查

安装

npm install -g @earendil-works/pi-coding-agent

## 速览

Pi Agent Harness 官方单仓库：自扩展编程 agent CLI、agent 运行时、统一多厂商 LLM API、TUI 库与遥测契约——本地图上的其他一切都构建在它之上。

## 要点

$五个发布包：@earendil-works/pi-coding-agent（交互式 CLI）、pi-agent-core（带工具调用与状态管理的 agent 运行时）、pi-ai（统一 LLM API，覆盖 OpenAI、Anthropic、Google 等）、pi-tui（差分渲染终端 UI）、pi-telemetry（遥测契约）。
$Pi 没有内建权限系统——它以启动用户的权限运行。官方文档给出三种容器化隔离方案：Gondolin 扩展（工具路由进本地 micro-VM）、纯 Docker、OpenShell 策略沙箱。
$供应链加固是一等公民：直接依赖精确锁版、发布 CLI 内置 npm shrinkwrap、依赖生命周期脚本白名单、发布前在隔离环境做冒烟安装测试。
$新贡献者的 issue 与 PR 默认自动关闭，维护者每日复核自动关闭队列（见 CONTRIBUTING.md）。
$维护者公开分享真实的 OSS agent 会话（经 pi-share-hf 发布到 Hugging Face），为生态提供真实任务与工具使用数据。

## 常见问题

Q 如何安装编程 agent？

CLI 以 npm 包发布：npm install -g @earendil-works/pi-coding-agent，然后运行 pi；pi update --self 可原地自更新。

Q Pi 会沙箱化工具执行吗？

不会。Pi 刻意不内建权限系统，以你的用户权限运行。需要隔离时，容器化文档提供 Gondolin（auth 留宿主机、工具进 micro-VM）、纯 Docker 与 OpenShell 三种方案。

Q 长期设计规划在哪里？

RFC 发布在 rfc.earendil.com（关键词 pi），面向人类与 agent 的项目规则见仓库根目录的 AGENTS.md。

## 参考链接

## 相关条目

## 教程

最后更新: 2026年8月31日