earendil-works/pi
Pi 是一个以终端编程助手为入口的轻量级 AI 智能体工具包。它适合想按自己的开发流程定制编程助手的人,也适合需要在 TypeScript 应用中复用多模型接口和智能体运行能力的开发者。
命令行背后的组件
pi-ai 为 OpenAI、Anthropic、Google 等模型服务提供统一接口,pi-agent-core 负责智能体循环中的工具调用和状态管理,pi-tui 提供终端界面,pi-coding-agent 则是交互式编程助手的命令行入口。读源码时,可以从命令行包了解交互入口,再到 pi-agent-core 看任务执行,或到 pi-ai 看模型接入。
定制与集成
扩展、技能、提示词模板和主题可以打包成 Pi 软件包,经 npm 或 Git 分享。需要子智能体或计划模式时,可以自行扩展或选装提供对应功能的软件包。日常编程可以用交互模式,脚本可以用打印或 JSON 模式,外部程序可以通过 RPC 控制 Pi,也可以用 TypeScript SDK 将它集成到应用里。
试用入口与权限
可以先看 README 的 Getting started 和官方文档。Pi 要求 Node.js 22.19 或更新版本,macOS、Linux 和 Windows 的安装器可在需要时安装 Node.js。安装后,在目标项目目录启动 Pi,再用 /login 为内置模型服务配置订阅或 API 密钥。例如,可以先请它梳理项目入口和模块关系。
Pi 默认沿用启动用户和进程的权限。需要单独限制它对文件系统、进程、网络或凭据的访问时,可以参考官方容器化文档,在容器或沙箱里运行。
发表回复