設定

Pi は、グローバル設定をオーバーライドするプロジェクト設定を持つ JSON 設定ファイルを使用します。

直接編集するか、一般的なオプションに /settings を使用します。

インタラクティブな起動時に、pi は、プロジェクトのローカル設定、リソース、またはプロジェクト .agents/skills が含まれており、~/.pi/agent/trust.json のフォルダーまたは親フォルダーに対する決定が保存されていないプロジェクト フォルダーを信頼する前に質問します。プロジェクトを信頼すると、pi は .pi/settings.json および .pi リソースをロードし、不足しているプロジェクト パッケージをインストールし、プロジェクト拡張機能を実行できます。

非対話型モード (-p、--mode json、および --mode rpc) では、信頼プロンプトは表示されません。該当する保存された信頼決定がなければ、グローバル設定の defaultProjectTrust を使用します: ask (デフォルト) と never はこれらのプロジェクト リソースを無視し、always はそれらを信頼します。 --approve/-a または --no-approve/-na を渡して、1 回の実行でプロジェクトの信頼をオーバーライドします。

拡張機能または保存された決定が適用されない場合、defaultProjectTrust はフォールバック動作を制御します。 ~/.pi/agent/settings.jsonで"ask"、"always"、"never"に設定するか、/settingsで変更します。

pi config とパッケージ コマンドは、pi update がプロンプトを表示しないことを除き、同じプロジェクト信頼フローを使用します。 1 つのコマンドに対してプロジェクトのローカル設定を信頼するには --approve を、無視するには --no-approve を渡します。

対話モードで /trust を使用すると、直接の親フォルダーに対する信頼を含め、将来のセッションのためにプロジェクトの信頼決定を保存できます。 ~/.pi/agent/trust.json のみを書き込みます。現在のセッションはリロードされないため、変更を有効にするために pi を再起動します。

{
  "thinkingBudgets": {
    "minimal": 1024,
    "low": 4096,
    "medium": 10240,
    "high": 32768
  }
}

VS Code の場合、エディターが終了した後に pi が再開されるように、--wait を含めます。

{
  "externalEditor": "code --wait"
}

enableInstallTelemetry は、https://pi.dev/api/report-install への匿名インストール/更新 ping のみを制御します。テレメトリをオプトアウトしても、更新チェックは無効になりません。 Pi は引き続き https://pi.dev/api/latest-version をフェッチして最新バージョンを探すことができます。

Pi バージョン更新チェックを無効にするには、PI_SKIP_VERSION_CHECK=1 を設定します。 --offline または PI_OFFLINE=1 を使用して、更新チェック、パッケージ更新チェック、インストール/更新テレメトリなど、ここで説明するすべての起動ネットワーク操作を無効にします。

{
  "httpProxy": "http://127.0.0.1:7890"
}

{
  "warnings": {
    "anthropicExtraUsage": false
  }
}

{
  "compaction": {
    "enabled": true,
    "reserveTokens": 16384,
    "keepRecentTokens": 20000
  }
}

プロバイダーが retry.provider.maxRetryDelayMs より長い再試行遅延をリクエストすると、リクエストはサイレントに待機するのではなく、有益なエラーが表示されてただちに失敗します。制限を無効にするには、0 に設定します。

プロバイダーレベルの再試行が明示的に必要でない限り、retry.provider.maxRetries を 0 のままにしておきます。 0 より上に設定すると、SDK/プロバイダーは、Pi がエラーを検出する前に使用量制限外エラーの処理を再試行するため、状況によってはプロバイダー クォータがリセットされるまでエージェントがブロックされる可能性があります。

{
  "retry": {
    "enabled": true,
    "maxRetries": 3,
    "baseDelayMs": 2000,
    "provider": {
      "timeoutMs": 3600000,
      "maxRetries": 0,
      "maxRetryDelayMs": 60000
    }
  }
}

{
  "npmCommand": ["mise", "exec", "node@20", "--", "npm"]
}

npmCommand は、git パッケージ内のインストール、アンインストール、依存関係のインストールを含む、すべての npm パッケージ マネージャー操作に使用されます。ユーザースコープの npm パッケージは ~/.pi/agent/npm/ にインストールされます。プロジェクト スコープの npm パッケージは .pi/npm/ にインストールされます。プロセスを起動する必要があるとおりに、argv スタイルのエントリを正確に使用してください。 npmCommand が設定されている場合、git パッケージの依存関係インストールでは、ラッパーまたは代替パッケージ マネージャーの npm 固有のフラグを回避するために、プレーンな install が使用されます。

{ "sessionDir": ".pi/sessions" }

複数のソースでセッション ディレクトリが指定されている場合、settings.json では優先順位は --session-dir、PI_CODING_AGENT_SESSION_DIR、次に sessionDir です。

{
  "enabledModels": ["claude-*", "gpt-4o", "gemini-2*"]
}

これらの設定は、拡張機能、スキル、プロンプト、テーマの読み込み元を定義します。

~/.pi/agent/settings.json のパスは ~/.pi/agent を基準にして解決されます。 .pi/settings.json のパスは .pi を基準にして解決されます。絶対パスと ~ がサポートされています。

配列は、グロブ パターンと除外をサポートします。除外するには !pattern を使用します。正確なパスを強制的に含めるには +path を使用し、正確なパスを強制的に除外するには -path を使用します。

文字列形式はパッケージからすべてのリソースを読み込みます。

{
  "packages": ["pi-skills", "@org/my-extension"]
}

オブジェクト フォームは、ロードするリソースをフィルターします。

{
  "packages": [
    {
      "source": "pi-skills",
      "skills": ["brave-search", "transcribe"],
      "extensions": []
    }
  ]
}

パッケージ管理の詳細については、packages.md を参照してください。

{
  "defaultProvider": "anthropic",
  "defaultModel": "claude-sonnet-4-20250514",
  "defaultThinkingLevel": "medium",
  "theme": "dark",
  "compaction": {
    "enabled": true,
    "reserveTokens": 16384,
    "keepRecentTokens": 20000
  },
  "retry": {
    "enabled": true,
    "maxRetries": 3
  },
  "enabledModels": ["claude-*", "gpt-4o"],
  "warnings": {
    "anthropicExtraUsage": true
  },
  "packages": ["pi-skills"]
}

プロジェクト設定 (.pi/settings.json) はグローバル設定をオーバーライドします。ネストされたオブジェクトはマージされます。

// ~/.pi/agent/settings.json (global)
{
  "theme": "dark",
  "compaction": { "enabled": true, "reserveTokens": 16384 }
}

// .pi/settings.json (project)
{
  "compaction": { "reserveTokens": 8192 }
}

// Result
{
  "theme": "dark",
  "compaction": { "enabled": true, "reserveTokens": 8192 }
}