開発

追加のガイドラインは 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"
  }
}

フォーク用に name、configDir、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                         # 非 LLM テストを実行（API キー不要）
npm test                          # すべてのテストを実行
npm test -- test/specific.test.ts # 特定のテストを実行

プロジェクト構造

packages/
  ai/           # LLM プロバイダー抽象化
  agent/        # エージェントループとメッセージ型
  tui/          # ターミナル UI コンポーネント
  coding-agent/ # CLI と対話モード