Pi Coding Agent

Pi Coding Agent 是一个开源、轻量且高度可扩展的终端 AI 编程智能体（Coding Agent），由 Earendil Works 开发。官方将 Pi 定位为一个 “minimal terminal coding harness”（轻量的终端编程智能体框架），核心理念是保持 Agent 核心简洁，同时通过 Extensions、Skills、Prompt Templates、Themes 和 Pi Packages 等机制，让开发者根据自己的需求定制 AI 编程工作流。

Pi 的核心代码托管在 GitHub，主要包含 pi-coding-agent、pi-agent-core 和 pi-ai 等组件。其中 pi-coding-agent 是面向用户的交互式 AI 编程 CLI，pi-agent-core 负责 Agent 运行时、工具调用和状态管理，pi-ai 则提供统一的多模型提供商接口。

核心功能

终端 AI 编程

Pi 主要运行在终端中，进入项目目录后即可启动，通过自然语言向 AI 提出编程任务。默认情况下，Pi 为模型提供 read、write、edit 和 bash 四个核心工具，使 AI 能够读取项目文件、创建和修改文件以及执行 Shell 命令。

因此，Pi 可以用于代码理解、功能开发、Bug 修复、代码重构、测试以及项目维护等常见软件开发任务。

支持多种模型和提供商

Pi 并不绑定单一 AI 模型，而是提供统一的模型和供应商接口，可以连接多种主流 AI 模型服务。官方维护各内置提供商的可用模型列表，并支持通过 /model 或快捷键切换模型。

目前支持的服务包括 Anthropic、OpenAI、Google、Azure OpenAI、Amazon Bedrock、DeepSeek、Mistral、Groq、Cerebras、xAI、OpenRouter、Hugging Face、NVIDIA、Kimi For Coding、MiniMax、ZAI 等，同时也支持自定义模型和提供商。

Pi 支持通过 API Key 使用模型，也支持部分服务通过 /login 使用现有订阅进行认证，例如 Anthropic Claude Pro/Max、OpenAI ChatGPT Plus/Pro（Codex）和 GitHub Copilot。

高度可扩展

Pi 最突出的特点之一是高度可扩展。它允许开发者通过 TypeScript Extensions、Skills、Prompt Templates 和 Themes 扩展功能，并可以将这些扩展打包成 Pi Packages，通过 npm 或 Git 与其他用户共享。

Extensions 可以用于添加自定义工具、命令、快捷键、UI、模型提供商以及各种自动化工作流；Skills 则可以为 Agent 提供特定领域的操作能力和知识。

官方仓库还提供了大量扩展示例，包括自定义工具、子智能体（Subagents）、Git 集成、SSH、文件监听、权限控制、自定义 UI 和上下文处理等。

上下文与会话管理

Pi 支持使用项目级和用户级配置、上下文文件、Skills 和 Prompt Templates 来控制 Agent 的行为，可以根据不同项目设置开发规范和工作流程。

同时支持会话历史、分支和上下文压缩等功能，可以在较长的开发任务中继续之前的工作，而不必每次从头开始。官方文档也提供了会话管理、上下文文件等相关功能说明。

多种运行模式

除了交互式终端模式之外，Pi 还提供多种运行方式：

• Interactive Mode：主要的终端交互式 AI 编程体验。
• Print / JSON Mode：适合脚本和自动化场景。
• RPC Mode：通过 stdin/stdout 使用 JSONL 协议与其他程序进行集成。
• SDK：可以将 Pi 的 Agent 能力嵌入自己的 Node.js / TypeScript 应用中。

因此，Pi 不仅可以作为个人开发者的终端 Coding Agent 使用，也可以作为构建其他 AI 编程工具和自动化系统的基础组件。

安装与使用

Pi Coding Agent 可以通过 npm 安装。首先确保系统已经安装 Node.js，然后执行：

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

--ignore-scripts 用于禁用依赖包的生命周期脚本，Pi 的正常 npm 安装并不依赖这些安装脚本。当前版本要求 Node.js 22.19.0 或更高版本。

安装完成后，进入需要让 Pi 操作的项目目录：

cd /path/to/project
pi

启动后即可直接通过自然语言向 Pi 提出编程任务。

使用官方安装脚本

Linux 和 macOS 用户也可以使用 Pi 官方安装脚本：

curl -fsSL https://pi.dev/install.sh | sh

Windows 用户可以使用 PowerShell 官方安装脚本：

powershell -c "irm https://pi.dev/install.ps1 | iex"

安装完成后，在项目目录中运行：

pi

即可启动 Pi。

配置模型

Pi 支持通过 API Key 使用模型，也可以使用部分服务提供的订阅认证。

例如配置 Anthropic API Key：

export ANTHROPIC_API_KEY=sk-ant-...
pi

也可以直接启动 Pi，然后执行：

/login

根据提示选择相应的模型提供商进行认证。

启动 Pi 后，可以通过 /model 或相应快捷键选择可用模型。

与其他 AI 编程工具的区别

Pi 与 Claude Code、Codex CLI、OpenCode 等 AI 编程工具一样，都可以在终端中使用 AI 完成软件开发任务，但它的设计理念有所不同。

Pi 强调 “最小核心 + 高度扩展”。官方有意没有将一些其他 Coding Agent 中常见的功能全部内置，例如 Sub-agents、Plan Mode、内置 Todo、后台 Bash 和 MCP 等，而是鼓励用户通过 Extensions、Skills、Pi Packages 或其他外部工具自行构建这些能力。

例如，官方仓库本身就提供了 Subagent 等扩展示例；用户也可以通过第三方 Pi Package 获得更多高级功能。因此，“没有内置”并不代表“无法实现”，而是意味着用户可以按照自己的工作方式选择实现方案。

这种设计使 Pi 更适合希望掌控 AI 编程工作流、深度定制 Agent 行为，或者基于现有 Agent 能力构建自己的工具的开发者。

开源与生态

Pi 是开源项目，源码托管于 GitHub，并采用 MIT License。项目采用 monorepo 结构，除了面向用户的 pi-coding-agent 外，还包括 pi-agent-core、pi-ai、pi-tui 等相关组件。

Pi 还拥有开放的 Pi Packages 机制，可以将 Extensions、Skills、Prompt Templates 和 Themes 打包，通过 npm 或 Git 安装和共享。用户可以使用以下命令管理 Pi Packages：

pi install <package>
pi remove <package>
pi update --all
pi list

这使 Pi 不仅是一个 AI 编程 CLI，也逐渐形成了围绕 Agent 扩展和工作流的开放生态。

适合哪些用户

Pi Coding Agent 更适合以下用户：

• 希望在终端中使用 AI 辅助编程的开发者；
• 希望自由选择不同 AI 模型和 API 服务的用户；
• 希望高度定制 Coding Agent 工作流的开发者；
• 希望通过 Extensions、Skills 和 Packages 扩展 Agent 能力的用户；
• 希望基于 Agent SDK 或 RPC 构建自己的 AI 编程工具的开发者；
• 希望研究和构建自定义 AI Agent Harness 的开发者。

对于只希望安装后即可获得完整、固定工作流的用户，Pi 的学习和配置成本可能相对更高；但对于希望自己决定 Agent 应该怎么工作的开发者，Pi 的灵活性是其重要优势。

总结

Pi Coding Agent 是一个开源、终端优先、轻量且高度可扩展的 AI 编程智能体。它以精简的 Agent 核心为基础，提供文件读写、代码编辑和 Shell 执行等基本能力，并通过 Extensions、Skills、Prompt Templates、Themes 和 Pi Packages 构建开放的扩展体系。

相比功能高度集成的 AI 编程产品，Pi 更强调开发者对 Agent 工作流的控制和定制。它既可以直接作为个人开发者的终端 Coding Agent 使用，也可以通过 RPC 和 SDK 集成到其他应用中，适合希望深入定制 AI 编程流程以及构建自定义 Agent 工具的开发者。