Pi için yapılandırma, özelleştirme, platform kurulumu ve API referansları.

Geliştirme

Ek yönergeler için AGENTS.md'e bakın.

Kurulum

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

Kaynak koddan çalıştırın:

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

Komut dosyası herhangi bir dizinden çalıştırılabilir. Pi, çağıran işlemin mevcut çalışma dizinini korur.

Çatallanma / Yeniden Markalama

package.json aracılığıyla yapılandırın:

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

Fork'unuz için name, configDir ve bin alanlarını değiştirin. Bu alanlar CLI başlığını, yapılandırma yollarını ve ortam değişkeni adlarını etkiler.

Yol Çözünürlüğü

Üç yürütme modu vardır: npm kurulumu, bağımsız ikili dosya ve kaynak koddan tsx.

Paket varlıkları için her zaman src/config.ts kullanın:

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

Paket varlıkları için hiçbir zaman doğrudan __dirname kullanmayın.

Hata Ayıklama Komutu

/debug (gizli) ~/.pi/agent/pi-debug.log'ye yazar:

  • ANSI kodlarıyla oluşturulan TUI satırları
  • LLM'ye gönderilen son mesajlar

Test

./test.sh                         # Run non-LLM tests (no API keys needed)
npm test                          # Run all tests
npm test -- test/specific.test.ts # Run specific test

Proje Yapısı

packages/
  ai/           # LLM provider abstraction
  agent/        # Agent loop and message types  
  tui/          # Terminal UI components
  coding-agent/ # CLI and interactive mode