project
Pi - 开源的终端编程 Agent，支持自定义工具与模型接入
Pi （Agent Harness） 是极简开源的终端编程 Agent，由 Mario Zechner 推出，同时是 OpenClaw 的底层 Coding Agent。工具只给模型 read、write、edit、bash ...
Pi是什么
Pi （Agent Harness） 是极简开源的终端编程 Agent，由 Mario Zechner 推出，同时是 OpenClaw 的底层 Coding Agent。工具只给模型 read、write、edit、bash 四个基础工具，系统提示词不到 1000 token，其余功能全部交给 TypeScript 扩展。Pi支持 15+ 模型提供商、树状分叉会话、跨厂商切模型。
Pi的主要功能
- 极简工具集：默认只给模型 read、write、edit、bash 四个工具，搜索等操作让模型自行用 grep/find 解决，系统提示词不到 1000 token。
- 多模型接入：内置 15+ 提供商（Anthropic、OpenAI、Kimi、DeepSeek、MiniMax 等），支持 OAuth 订阅登录和 API Key 两种方式。
- 树状会话历史：会话以树形结构存储，可随时跳回任意历史节点重新提问、分叉试错，所有分支共存于一个文件。
- 跨厂商切模型：会话中途可通过
/model或Ctrl+L切换不同厂商模型，上下文自动交接转换。 - 四种运行模式：交互式 TUI、Print/JSON 脚本模式、RPC 协议、Node.js SDK，满足从日常编码到程序集成的不同场景。
- 扩展自定制：TypeScript 扩展模块扔进目录可热加载，能注册自定义工具、命令，拦截事件，可让 Pi 现场给自己写扩展。
- Skills 与 Prompt 模板：支持 Agent Skills 标准，Markdown 文件可直接变为带参数的
/命令。 - 社区包生态：扩展、Skills、模板、主题可打包为 Pi packages，通过
pi install npm:xxx或 git 仓库一键安装分享。 - 兼容现有配置：自动沿目录树查找并识别 AGENTS.md 和 CLAUDE.md，原有 Claude Code 配置无需迁移。
- 上下文工程：支持 SYSTEM.md 覆盖系统提示词、自动 Compaction 摘要、动态上下文注入，让用户精确控制进入上下文窗口的每个 token。
微信关注回复“开源”，加入AI开源项目交流群
如何使用Pi
- 安装：通过运行
npm install -g --ignore-scripts @earendil-works/pi-coding-agent或curl -fsSL https://pi.dev/install.sh | sh在终端中安装 Pi。 - 启动：安装完成后，在终端输入
pi可进入交互式 TUI 界面。 - 登录配置：首次使用需运行
/login，选择 OAuth 订阅登录或填入 API Key 来配置模型提供商。 - 进入项目：进入你的项目目录并输入
pi，Pi 会自动加载当前目录及父目录下的AGENTS.md或CLAUDE.md作为上下文。 - 开始对话：在交互界面直接用自然语言描述需求，使用
@模糊搜索文件、!执行 Shell 命令、Ctrl+V粘贴图片。 - 切换模型：如需更换模型，可随时输入
/model或按Ctrl+L在不同厂商模型间切换，上下文会自动交接。 - 树状回溯：用
/tree命令查看树状会话历史，可跳回任意节点重新提问或分叉试错。 - 扩展功能：如需扩展功能，可在
~/.pi/agent/extensions/目录编写 TypeScript 扩展模块，保存后输入/reload热加载生效。 - 导出分享：会话结束后，可用
/export导出为 HTML，或用/share生成 GitHub Gist 分享链接。 - 退出续接：按
Ctrl+C或Ctrl+D即可退出当前会话，下次用pi -c可继续上一次的对话。
Pi的核心优势
- 极简高效：系统提示词加工具定义不到 1000 token，只给模型四个基础工具，响应速度极快。
- 精确上下文控制：支持 SYSTEM.md、AGENTS.md、动态上下文注入和自动 Compaction，你能决定每个 token 怎么进上下文。
- 超强扩展性：TypeScript 扩展热加载即生效，甚至可以让 Pi 现场给自己写扩展，官方不做的东西社区用包补齐。
- 树状会话历史：会话以树形结构存储，可随时跳回任意节点重新分叉试错，避免线性对话的沉没成本。
- 跨厂商无缝切换：内置 15+ 提供商，会话中途随时切换不同厂商模型，上下文自动交接转换。
- 零迁移成本：自动识别 CLAUDE.md 和 AGENTS.md，Skills 标准与 Claude Code、Codex 通用，原有配置直接复用。
- 国产模型友好：内置 DeepSeek、Kimi、智谱、Qwen、MiniMax、MiMo 等国产模型，且单独配置了中国区节点。
- 完全开源 MIT：代码全公开，供应链安全 hardened，社区已衍生出 Go、Rust、Python 等多个移植版本。
- 四种运行模式：交互 TUI、Print/JSON、RPC、SDK 覆盖从日常编码到企业集成的全场景需求。
- 自解释能力：Pi 能解释自己的功能和文档，甚至能直接帮你查文档、写配置，降低上手门槛。
Pi的项目地址
- 项目官网：https://pi.dev/
- GitHub仓库：https://github.com/earendil-works/pi
Pi的同类竞品对比
| 维度 | Pi | Claude Code |
|---|---|---|
| 定位 | 极简可扩展的 Agent Harness | 全功能开箱即用的 Coding Agent |
| 系统提示词 | < 1000 token，极简 | 上万 token，功能丰富 |
| 内置工具 | 仅 4 个：read、write、edit、bash | 大量内置工具，含文件搜索、代码分析等 |
| Sub-agents | 不做内置，需自行用 bash spawn 或装扩展 | 原生支持 |
| Plan Mode | 不做内置，建议写 PLAN.md | 原生支持 |
| MCP 支持 | 不做内置，社区有 pi-mcp-adapter |
原生支持 |
| 权限确认 | 默认 YOLO 模式，不弹窗 | 有权限弹窗确认机制 |
| 模型支持 | 15+ 提供商，可跨厂商切换 | 仅限 Anthropic Claude |
| 会话结构 | 树状历史，支持分叉回溯 | 线性历史 |
Pi的应用场景
- 快速脚本与原型开发：在终端直接用自然语言生成、调试和运行脚本，树状会话支持快速试错不同实现方案。
- 代码库重构与维护：用 Pi 的代码编辑能力和跨模型切换特性，在大型项目中进行批量重构，同时通过 AGENTS.md 沉淀项目规范。
- 自定义开发工作流：通过编写 TypeScript 扩展，将 Pi 改造成符合团队或个人的专属工具链（如自动代码审查、文档生成、特定框架脚手架）。
- 开源协作与知识分享：用
/share导出 GitHub Gist 或/export生成 HTML，将完整的调试和开发过程分享给协作者或用于技术博客。 - 远程服务器与容器化开发：在 SSH 服务器或 Docker 容器中运行 Pi，配合 tmux 实现后台持久化会话，适合云端开发、CI/CD 流水线集成等无图形界面环境。