Pi Coding Agent

why

各 Agent 都在走向综合超强，Pi 走向高度可定制。

其优势，一是极简，系统 token 消耗少，基础工具少（grep、find、ls、read、write、edit、bash 等）启动快。

二是高度可定制能力（在 ~/.pi 文件夹中管理）：

• 扩展：注册新工具、替换内置工具或完全改变工具调用逻辑
• 技能
• 提示词模板

how

# 安装
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# 启动
cd $project
pi

what

○ 添加模型 API

/login -> deepseek -> 输入 API key -> 存储

/model 切换模型（默认 deepseek pro，切换到 flash）

○ 会话管理

/quit 退出会话

/new 新建会话

/resume 恢复会话

/reload 重新加载：按键绑定、扩展、技能、提示词、上下文文件

/hotkeys 查看快捷键

TIP

• @：引用文件，支持模糊搜索
• !：执行命令，其中 i 执行后发给模型，ii 执行后不发给模型
• ctrl+v：可粘贴图片

○ 管理项目偏好

自定义 AGNETS.md，在 reload。

# AGENTS.md - AI 协作规则

## 1. 基本行为准则

- 始终使用**中文**回复，代码注释和文档也用中文（除非代码本身要求英文）。
- 回答要**简洁、直接**，避免冗长的大道理。
- 修改代码前，**先说明修改计划**，得到用户确认后再执行（紧急 bug 修复除外）。
- 每次代码修改后，用 emoji ✅ 提示用户，并简要说明改动点。

## 2. 交互约定

## 3. 代码生成约定

## 4. 项目约定

○ 自定义：prompt

1. 添加模板文件 ~/.pi/agent/prompts/<prompt>.md
2. 编辑 prompt 内容，示例见下
3. 提问时引用模板 /<prompt>
4. 可加参数 $1 等

---
description: Review staged git changes
---

Review the staged changes (`git diff --cached`). Focus on:

- Bugs and logic errors
- Security issues
- Error handling gaps

○ 自定义：hook

通过 pi.on() 在不同生命周期注入自定义逻辑。

○ 自定义：extension

1. 添加扩展的 ts 文件 ~/.pi/agent/extensions/<extension>.ts
2. 添加默认导出方法 export default async function(pi: ExtensionAPI) {}
3. 在方法中注册新工具、斜杠命令等：pi.registerTool()、pi.registerCommand()

○ 其他

• 让 pi 默认较为可用，无需过多自定义配置：trellis 仓库有专门的 .pi 目录，可复制来用

参考

• Using Pi