$ cat ~/map/pi-coding-agent-npm.md

@earendil-works/pi-coding-agent

官方 npm 包——一条命令即可安装 Pi 编程 agent CLI。

officialtools✓ 10月16日

事实速查

安装

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

## 速览

pi 的官方 npm 包——一条文档写明的全局安装命令即可获得 pi 可执行文件：一个带 read、bash、edit、write 四件工具与会话管理的编码 agent CLI。

$由 @earendil-works 维护的官方 scoped 包；提供 pi 可执行文件（bin: pi），npm 描述为带 read、bash、edit、write 工具与会话管理的编码 agent CLI。源码位于 earendil-works/pi monorepo 的 coding-agent 包中。
$文档写明的安装方式是 npm install -g --ignore-scripts @earendil-works/pi-coding-agent——--ignore-scripts 会在安装期间禁用依赖的生命周期脚本，而 pi 的常规 npm 安装并不需要这些脚本。
$Linux/macOS 备选安装器：curl -fsSL https://pi.dev/install.sh | sh；卸载用 npm uninstall -g @earendil-works/pi-coding-agent，pnpm、Yarn、Bun 用户使用各自对应的全局移除命令。
$包要求 Node.js >=22.19.0（engines 字段）。在项目目录运行 pi 启动，随后用 /login 完成订阅类 provider 登录，或预先设置 ANTHROPIC_API_KEY 之类的 API key。
$默认给模型四件工具——read、write、edit、bash——并以四种模式运行：交互式 TUI、print/JSON、供进程集成的 RPC，以及可嵌入的 SDK。完整文档在 pi.dev。

Q 为什么要加 --ignore-scripts？

它会在安装期间禁用依赖的生命周期脚本。pi 不依赖这些脚本也能正常工作，加上该标志可以避免执行你并未要求的第三方 postinstall 脚本。

Q 怎么更新或卸载？

重新执行全局 npm install（或所用包管理器的全局更新）即可升级；卸载用 npm uninstall -g @earendil-works/pi-coding-agent——pnpm、Yarn 与 Bun 用户请使用各自对应的全局移除命令。