Pi の設定、拡張、プラットフォーム設定、API リファレンス。

発達

追加のガイドラインについては、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 は、呼び出し元の現在の作業ディレクトリを保持します。

フォーク/リブランディング

package.json 経由で設定します:

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

フォークの nameconfigDir、および bin フィールドを変更します。 CLI バナー、設定パス、環境変数名に影響します。

パスの解決

3 つの実行モード: npm インストール、スタンドアロン バイナリ、ソースからの tsx。

パッケージ アセットには常に src/config.ts を使用します。

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

__dirname をパッケージ アセットに直接使用しないでください。

デバッグコマンド

/debug (非表示) は ~/.pi/agent/pi-debug.log に書き込みます:

  • ANSI コードを使用してレンダリングされた TUI 行
  • LLM に送信された最後のメッセージ

テスト

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

プロジェクトの構造

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