Cấu hình, tùy chỉnh, thiết lập nền tảng và tham chiếu API cho Pi.

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 build

Chạy từ nguồn:

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

Tậ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, configDirbin 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 test

Cấ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