Pengaturan

Pi menggunakan file pengaturan JSON dengan pengaturan proyek menggantikan pengaturan global.

Edit secara langsung atau gunakan /settings untuk opsi umum.

Pada startup interaktif, pi bertanya sebelum memercayai folder proyek yang berisi pengaturan lokal proyek, sumber daya, atau proyek .agents/skills dan tidak memiliki keputusan tersimpan untuk folder atau folder induk di ~/.pi/agent/trust.json. Mempercayai suatu proyek memungkinkan pi memuat sumber daya .pi/settings.json dan .pi, menginstal paket proyek yang hilang, dan menjalankan ekstensi proyek.

Mode non-interaktif (-p, --mode json, dan --mode rpc) tidak menampilkan prompt kepercayaan. Tanpa keputusan perwalian tersimpan yang dapat diterapkan, mereka menggunakan defaultProjectTrust dari pengaturan global: ask (default) dan never mengabaikan sumber daya proyek tersebut, sementara always memercayainya. Lewati --approve/-a atau --no-approve/-na untuk mengesampingkan kepercayaan proyek dalam sekali proses.

Jika tidak ada perpanjangan atau keputusan tersimpan yang berlaku, defaultProjectTrust mengontrol perilaku fallback. Setel ke "ask", "always", atau "never" di ~/.pi/agent/settings.json, atau ubah dengan /settings.

pi config dan perintah paket menggunakan aliran kepercayaan proyek yang sama, kecuali pi update tidak pernah diminta. Lewati --approve untuk memercayai pengaturan proyek-lokal untuk satu perintah atau --no-approve untuk mengabaikannya.

Gunakan /trust dalam mode interaktif untuk menyimpan keputusan kepercayaan proyek untuk sesi mendatang, termasuk kepercayaan untuk folder induk langsung. Ia hanya menulis ~/.pi/agent/trust.json; sesi saat ini tidak dimuat ulang, jadi mulai ulang pi agar perubahan diterapkan.

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

Untuk VS Code, sertakan --wait sehingga pi dilanjutkan setelah editor keluar:

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

enableInstallTelemetry hanya mengontrol ping pemasangan/pembaruan anonim ke https://pi.dev/api/report-install. Menolak telemetri tidak menonaktifkan pemeriksaan pembaruan; Pi masih dapat mengambil https://pi.dev/api/latest-version untuk mencari versi terbaru.

Setel PI_SKIP_VERSION_CHECK=1 untuk menonaktifkan pemeriksaan pembaruan versi Pi. Gunakan --offline atau PI_OFFLINE=1 untuk menonaktifkan semua operasi jaringan startup yang dijelaskan di sini, termasuk pemeriksaan pembaruan, pemeriksaan pembaruan paket, dan pemasangan/perbarui telemetri.

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

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

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

Ketika penyedia meminta penundaan percobaan ulang lebih lama dari retry.provider.maxRetryDelayMs, permintaan tersebut langsung gagal dengan kesalahan informatif alih-alih menunggu diam-diam. Setel ke 0 untuk menonaktifkan batas.

Pertahankan retry.provider.maxRetries di 0 kecuali percobaan ulang di tingkat penyedia secara eksplisit diperlukan. Menyetelnya di atas 0 dapat membuat SDK/percobaan ulang penyedia menangani kesalahan di luar batas penggunaan sebelum Pi melihatnya, yang dapat memblokir agen hingga kuota penyedia direset dalam beberapa keadaan.

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

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

npmCommand digunakan untuk semua npm operasi pengelola paket, termasuk pemasangan, pencopotan pemasangan, dan pemasangan ketergantungan di dalam paket git. Paket npm cakupan pengguna dipasang di bawah ~/.pi/agent/npm/; paket npm lingkup proyek dipasang di bawah .pi/npm/. Gunakan entri bergaya argv persis seperti proses yang harus diluncurkan. Saat npmCommand dikonfigurasi, penginstalan ketergantungan paket git menggunakan install biasa untuk menghindari tanda khusus npm di wrapper atau pengelola paket alternatif.

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

Jika beberapa sumber menentukan direktori sesi, prioritasnya adalah --session-dir, PI_CODING_AGENT_SESSION_DIR, lalu sessionDir di settings.json.

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

Pengaturan ini menentukan tempat memuat ekstensi, keterampilan, petunjuk, dan tema.

Jalur di ~/.pi/agent/settings.json terselesaikan relatif terhadap ~/.pi/agent. Jalur di .pi/settings.json terselesaikan relatif terhadap .pi. Jalur absolut dan ~ didukung.

Array mendukung pola dan pengecualian glob. Gunakan !pattern untuk mengecualikan. Gunakan +path untuk memaksa memasukkan jalur yang tepat dan -path untuk memaksa mengecualikan jalur yang tepat.

Formulir string memuat semua sumber daya dari sebuah paket:

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

Formulir objek memfilter sumber daya mana yang akan dimuat:

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

Lihat packages.md untuk detail manajemen paket.

{
  "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"]
}

Pengaturan proyek (.pi/settings.json) menggantikan pengaturan global. Objek bersarang digabungkan:

// ~/.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 }
}