开发

更多指南见 AGENTS.md。

环境搭建

git clone https://github.com/earendil-works/pi-mono
cd pi-mono
npm install
npm run build

从源码运行：

/path/to/pi-mono/pi-test.sh

该脚本可以在任何目录下运行。Pi 会保持调用者当前的目录。

Fork / 品牌重命名

通过 package.json 配置：

{
  "piConfig": {
    "name": "pi",
    "configDir": ".pi"
  }
}

为你的 fork 修改 name、configDir 和 bin 字段。这些会影响 CLI 横幅、配置路径和环境变量名。

路径解析

有三种执行模式：npm 安装、独立二进制、tsx 从源码运行。

包内资源一律使用 src/config.ts：

import { getPackageDir, getThemeDir } from "./config.js";

不要直接对包内资源使用 __dirname。

调试命令

/debug（隐藏命令）会写入 ~/.pi/agent/pi-debug.log：

• 带 ANSI 转义码的渲染后 TUI 行
• 发送给 LLM 的最后几条消息

测试

./test.sh                         # 运行非 LLM 测试（无需 API 密钥）
npm test                          # 运行全部测试
npm test -- test/specific.test.ts # 运行指定测试

项目结构

packages/
  ai/           # LLM 模型提供方抽象层
  agent/        # 智能体循环与消息类型
  tui/          # 终端 UI 组件
  coding-agent/ # CLI 与交互模式