Phát triển
Xem AGENTS.md để biết thêm hướng dẫn.
Cài đặt
git clone https://github.com/earendil-works/pi-mono
cd pi-mono
npm install
npm run buildChạy từ nguồn:
/path/to/pi-mono/pi-test.shTập lệnh có thể được chạy từ bất kỳ thư mục nào. Pi giữ thư mục làm việc hiện tại của người gọi.
Forking/Đổi thương hiệu
Định cấu hình qua package.json:
{
"piConfig": {
"name": "pi",
"configDir": ".pi"
}
}Thay đổi trường name, configDir và bin cho ngã ba của bạn. Ảnh hưởng đến biểu ngữ CLI, đường dẫn cấu hình và tên biến môi trường.
Độ phân giải đường dẫn
Ba chế độ thực thi: npm cài đặt, nhị phân độc lập, tsx từ nguồn.
Luôn sử dụng src/config.ts cho nội dung gói:
import { getPackageDir, getThemeDir } from "./config.js";Không bao giờ sử dụng trực tiếp __dirname cho nội dung gói.
Lệnh gỡ lỗi
/debug (ẩn) ghi vào ~/.pi/agent/pi-debug.log:
- Đã hiển thị các dòng TUI có mã ANSI
- Tin nhắn cuối cùng được gửi đến LLM
Kiểm tra
./test.sh # Run non-LLM tests (no API keys needed)
npm test # Run all tests
npm test -- test/specific.test.ts # Run specific testCấu trúc dự án
packages/
ai/ # LLM provider abstraction
agent/ # Agent loop and message types
tui/ # Terminal UI components
coding-agent/ # CLI and interactive mode