核心功能
系统提示词加工具定义不足1000 token，仅read/write/edit/bash四工具，不做内置plan、子Agent、MCP与权限弹窗。通过extension、skill与npm包机制扩展，支持交互TUI、print/JSON、RPC、SDK四种模式，被OpenClaw用作运行时底座。
功能亮点
极简核心
系统提示词与工具定义<1000 token，行为可预测
自我改造
让Agent直接修改自身代码，/reload热载即生效
模型自由切换
支持Anthropic等15+供应商，/model会话中切换
树状历史回滚
会话存为树，/tree回到任意节点继续且可分享
自定义模型 / 模型接入
多厂商支持
内置Anthropic、OpenAI、Google、Kimi、MiniMax、Ollama等15+供应商，models.json可加自定义模型。
接入方式
- 会话内 /login 交互式鉴权
- /model 或 Ctrl+L 切换模型
- ~/.pi/agent/models.json 添加自定义模型
- apiKey 支持 $ENV_VAR 环境变量插值
- AGENTS.md/SYSTEM.md 控制上下文
支持模型
Anthropic ClaudeOpenAI GPTGoogle GeminiKimi for CodingMiniMaxOllama本地模型
bash
models.json 中配置 OpenAI 兼容国产/自建网关：
{
"providers": {
"dashscope": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"api": "openai-completions",
"apiKey": "$DASHSCOPE_API_KEY",
"models": [{ "id": "qwen-max" }]
}
}
}
写入 ~/.pi/agent/models.json 后重启会话，用 /model 选择该模型适用场景
• 终端日常编码与重构
• 定制团队专属Agent
• CI/RPC/SDK自动化编程
• 自托管模型避免锁定
安装配置
bash
npm install -g --ignore-scripts @earendil-works/pi-coding-agent macOS/Linux：curl -fsSL https://pi.dev/install.sh | sh Windows：powershell -c "irm https://pi.dev/install.ps1 | iex"
使用方法
bash
cd 项目目录后运行 pi 进入交互TUI；/model 切换模型，/tree 回滚会话，/reload 热载扩展，/share 分享会话；脚本场景用 pi -p "查询"（print模式）或 --mode json；AGENTS.md 提供项目级指令。
优点
- 极简核心，行为可控
- 深度可自定义扩展
- 模型供应商覆盖广
- 树状历史可回滚分享
缺点
- 默认无权限隔离
- 无内置plan与子Agent
- 偏终端用户非图形IDE