earendil-works/pi

这是什么？

核心功能

• 01可在任意项目目录中运行的交互式编程 Agent 命令行工具。
• 02支持通过扩展、Skills、提示词模板和主题进行定制。
• 03统一的 LLM API，兼容 OpenAI、Anthropic、Google 等多家厂商。
• 04支持打印或 JSON 模式自动化、RPC 控制以及 TypeScript SDK。
• 05采用差分渲染的终端 UI 库。

适用场景

• 在终端中让编程 Agent 处理本地代码仓库。
• 基于 TypeScript SDK 构建自定义 Agent 工作流。
• 在脚本中通过打印或 JSON 输出自动化执行 Agent 任务。
• 为团队开发并分享自己的 Agent 扩展包。

快速上手

1. 1

   使用 pi.dev 安装脚本安装命令行工具

   按 README 中的官方说明安装
2. 2

   在项目目录中启动 Pi

   cd /path/to/project pi
3. 3

   在 Pi 中运行 /login 连接模型提供商，然后下达任务

使用前须知

• !通过 npm 安装需要 Node.js 22.19 或更新版本。
• !Pi 没有内置权限系统，除非额外沙箱化，否则以启动用户的全部权限运行。
• !内置 AI 提供商需要订阅或 API 密钥。

标签

常见问题

pi 是什么？

一个极简、可扩展的 AI Agent 框架，包含统一的多厂商 LLM API、Agent 运行时、终端 UI 和编程 Agent 命令行工具。 Pi 是一个用 TypeScript 编写的 monorepo，用于构建和运行 AI Agent。其核心产品是交互式编程 Agent 命令行工具，在项目目录中运行，可通过扩展、Skills、提示词模板和主题进行定制，并能打包成 Pi 包，通过 npm 或 git 分享。

pi 可以免费使用吗？用的什么许可证？

pi 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

pi 还在维护吗？

活跃维护中。pi 最近一次提交是在 2026年10月19日。

pi 适合用来做什么？

在终端中让编程 Agent 处理本地代码仓库。 基于 TypeScript SDK 构建自定义 Agent 工作流。 在脚本中通过打印或 JSON 输出自动化执行 Agent 任务。 为团队开发并分享自己的 Agent 扩展包。

pi 怎么安装和运行？

使用 pi.dev 安装脚本安装命令行工具 在项目目录中启动 Pi: cd /path/to/project pi 在 Pi 中运行 /login 连接模型提供商，然后下达任务

在哪里获取 pi？

源代码和安装说明在 GitHub 上：https://github.com/earendil-works/pi