Pi Coding Agent 是 Pi 项目提供的开源终端编码 Agent，也是一种强调小核心和可扩展性的 Coding Agent Harness。它把语言模型接入本地文件与命令环境，使模型能够读取代码、修改文件、执行命令，并依据执行结果继续处理任务。
项目定位
Pi Coding Agent 是可直接使用的编码工具；Pi 项目还提供模型接入和 Agent 运行组件。官方仓库将主要职责划分为：
pi-ai：统一多个模型提供商的调用接口。pi-agent-core：工具调用和状态管理等 Agent 运行能力。pi-coding-agent：面向开发者的交互式编码 CLI。
因此，Pi 既可以作为终端工具使用，也可以通过 RPC 或 SDK 接入其他应用。它属于 Agent Harness 的具体实现，模型能力由所连接的模型提供。来源：官方仓库
工作方式与扩展
默认工具为 read、write、edit 和 bash。模型通过这些工具观察代码、执行修改并获取反馈。运行入口包括交互式终端、非交互文本或 JSON 输出、RPC 和嵌入式 SDK。
Pi 通过 TypeScript Extensions、Skills、提示模板和主题扩展行为，并允许将这些内容打包为 Pi Packages，经 npm 或 Git 分发。其核心没有预设子 Agent 和计划模式；这些工作方式可以通过扩展构建。来源：Coding Agent README
会话与上下文
会话以树结构保存，可以回到历史节点并沿另一条分支继续。项目指令、按需加载的 Skills 和上下文压缩共同帮助管理长任务。扩展还可以调整上下文注入及历史处理方式。MCP 集成需要扩展等额外实现。来源：Pi 官网
安装与使用边界
截至 2026 年 9 月 6 日，旧仓库 badlogic/pi-mono 已重定向到 earendil-works/pi；旧资料中的 @mariozechner/pi-coding-agent 与当前官方安装名称不同。当前官方命令为：
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi
启动后仍需配置模型提供商的认证。来源：官方安装说明
Pi 默认继承启动进程的权限，核心没有内置完整的文件、进程、网络和凭据访问限制。需要隔离的工作应配合容器或沙箱；扩展中的确认流程不能直接等同于操作系统隔离。来源：官方权限说明
与 DeepSeek Harness 的关系
两者都连接模型与真实执行环境。Pi 的突出特点是围绕终端编码保留精简默认能力，再用扩展适配工作流；DeepSeek Harness 则将模型、循环、会话等运行能力统一组合为插件。这是架构侧重点的区别，不能直接推出任务成功率高低。