Ayarlar

Pi, proje ayarlarının genel ayarları geçersiz kıldığı JSON ayar dosyalarını kullanır.

Doğrudan düzenleyin veya ortak seçenekler için /settings kullanın.

Etkileşimli başlangıçta pi, proje yerel ayarlarını, kaynaklarını veya proje .agents/skills'yi içeren ve ~/.pi/agent/trust.json'deki klasör veya ana klasör için kayıtlı bir kararı olmayan bir proje klasörüne güvenmeden önce sorar. Bir projeye güvenmek pi'nin .pi/settings.json ve .pi kaynakları yüklemesine, eksik proje paketlerini yüklemesine ve proje uzantılarını yürütmesine olanak tanır.

Etkileşimli olmayan modlar (-p, --mode json ve --mode rpc) bir güven istemi göstermez. Geçerli bir kayıtlı güven kararı olmadan, genel ayarlardan defaultProjectTrust kullanırlar: ask (varsayılan) ve never bu proje kaynaklarını yok sayarken, always onlara güvenir. Bir çalıştırma için proje güvenini geçersiz kılmak için --approve/-a veya --no-approve/-na'yi geçin.

Hiçbir uzatma veya kayıtlı karar geçerli değilse, defaultProjectTrust geri dönüş davranışını kontrol eder. ~/.pi/agent/settings.json'de "ask", "always" veya "never" olarak ayarlayın veya /settings ile değiştirin.

pi config ve paket komutları aynı proje güven akışını kullanır, ancak pi update hiçbir zaman istemde bulunmaz. Bir komut için proje yerel ayarlarına güvenmek için --approve veya bunları yok saymak için --no-approve iletin.

Yakın ana klasöre yönelik güven de dahil olmak üzere gelecekteki oturumlar için bir proje güveni kararını kaydetmek için etkileşimli modda /trust tuşunu kullanın. Sadece ~/.pi/agent/trust.json yazıyor; geçerli oturum yeniden yüklenmediğinden değişikliklerin etkili olması için pi'yi yeniden başlatın.

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

VS Code için --wait ekleyin, böylece editör çıktıktan sonra pi devam eder:

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

enableInstallTelemetry yalnızca https://pi.dev/api/report-install'ye olan anonim kurulum/güncelleme pingini kontrol eder. Telemetriyi devre dışı bırakmak güncelleme kontrollerini devre dışı bırakmaz; Pi en son sürümü aramak için yine de https://pi.dev/api/latest-version'yi getirebilir.

Pi sürüm güncelleme kontrolünü devre dışı bırakmak için PI_SKIP_VERSION_CHECK=1 öğesini ayarlayın. Güncelleme kontrolleri, paket güncelleme kontrolleri ve kurulum/güncelleme telemetrisi dahil olmak üzere burada açıklanan tüm başlangıç ağ işlemlerini devre dışı bırakmak için --offline veya PI_OFFLINE=1 tuşlarını kullanın.

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

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

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

Bir sağlayıcı retry.provider.maxRetryDelayMs'den daha uzun bir yeniden deneme gecikmesi talep ettiğinde, istek sessizce beklemek yerine bilgilendirici bir hatayla hemen başarısız olur. Sınırı devre dışı bırakmak için 0 olarak ayarlayın.

Sağlayıcı düzeyinde yeniden denemelere açıkça ihtiyaç duyulmadığı sürece retry.provider.maxRetries'yi 0'de tutun. Bunu 0 değerinin üzerine ayarlamak, SDK/sağlayıcı yeniden denemelerinin kullanım sınırı dışı hataları Pi görmeden önce ele almasını sağlayabilir ve bu da bazı durumlarda sağlayıcı kotası sıfırlanana kadar aracıyı engelleyebilir.

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

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

npmCommand, git paketleri içindeki kurulumlar, kaldırmalar ve bağımlılık kurulumları dahil olmak üzere tüm npm paket yöneticisi işlemleri için kullanılır. Kullanıcı kapsamlı npm paketleri ~/.pi/agent/npm/ altına kurulur; proje kapsamlı npm paketleri .pi/npm/ altına kurulur. Argv tarzı girişleri tam olarak işlemin başlatılması gerektiği gibi kullanın. npmCommand yapılandırıldığında, git paketi bağımlılığı kurulumları, sarmalayıcılarda veya alternatif paket yöneticilerinde npm'ye özgü işaretlerden kaçınmak için düz install kullanır.

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

Birden fazla kaynak bir oturum dizini belirttiğinde, settings.json'da öncelik --session-dir, PI_CODING_AGENT_SESSION_DIR ve ardından sessionDir olur.

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

Bu ayarlar uzantıların, becerilerin, istemlerin ve temaların nereden yükleneceğini tanımlar.

~/.pi/agent/settings.json içindeki yollar ~/.pi/agent'ye göre çözümlenir. .pi/settings.json içindeki yollar .pi'ye göre çözümlenir. Mutlak yollar ve ~ desteklenir.

Diziler glob kalıplarını ve hariç tutmaları destekler. Hariç tutmak için !pattern tuşunu kullanın. Tam bir yolu zorunlu olarak dahil etmek için +path tuşunu, tam bir yolu zorla hariç tutmak için ise -path tuşunu kullanın.

Dize formu bir paketteki tüm kaynakları yükler:

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

Nesne formu hangi kaynakların yükleneceğini filtreler:

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

Paket yönetimi ayrıntıları için packages.md'e bakın.

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

Proje ayarları (.pi/settings.json) genel ayarları geçersiz kılar. İç içe geçmiş nesneler birleştirilir:

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