Paramètres

Pi utilise les fichiers de paramètres JSON avec les paramètres du projet remplaçant les paramètres globaux.

Modifiez directement ou utilisez /settings pour les options courantes.

Au démarrage interactif, pi demande avant de faire confiance à un dossier de projet qui contient des paramètres locaux du projet, des ressources ou un projet .agents/skills et n'a aucune décision enregistrée pour le dossier ou un dossier parent dans ~/.pi/agent/trust.json. Faire confiance à un projet permet à pi de charger les ressources .pi/settings.json et .pi, d'installer les packages de projet manquants et d'exécuter des extensions de projet.

Les modes non interactifs (-p, --mode json et --mode rpc) n'affichent pas d'invite de confiance. Sans décision de confiance enregistrée applicable, ils utilisent defaultProjectTrust à partir des paramètres globaux: ask (par défaut) et never ignorent ces ressources du projet, tandis que always leur fait confiance. Passez --approve/-a ou --no-approve/-na pour remplacer la confiance du projet pour une exécution.

Si aucune extension ou décision enregistrée ne s'applique, defaultProjectTrust contrôle le comportement de repli. Réglez-le sur "ask", "always" ou "never" dans ~/.pi/agent/settings.json, ou modifiez-le avec /settings.

Les commandes pi config et package utilisent le même flux de confiance du projet, sauf que pi update ne vous invite jamais. Passez --approve pour faire confiance aux paramètres locaux du projet pour une commande ou --no-approve pour les ignorer.

Utilisez /trust en mode interactif pour enregistrer une décision d'approbation de projet pour les sessions futures, y compris l'approbation pour le dossier parent immédiat. Il écrit ~/.pi/agent/trust.json uniquement; la session en cours n'est pas rechargée, alors redémarrez pi pour que les modifications prennent effet.

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

Pour VS Code, incluez --wait pour que pi reprenne après la fermeture de l'éditeur:

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

enableInstallTelemetry contrôle uniquement le ping anonyme d'installation/mise à jour vers https://pi.dev/api/report-install. La désactivation de la télémétrie ne désactive pas les vérifications de mise à jour; Pi peut toujours récupérer https://pi.dev/api/latest-version pour rechercher la dernière version.

Définissez PI_SKIP_VERSION_CHECK=1 pour désactiver la vérification de mise à jour de version Pi. Utilisez --offline ou PI_OFFLINE=1 pour désactiver toutes les opérations réseau de démarrage décrites ici, y compris les vérifications de mise à jour, les vérifications de mise à jour des packages et la télémétrie d'installation/mise à jour.

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

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

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

Lorsqu'un fournisseur demande un délai de nouvelle tentative supérieur à retry.provider.maxRetryDelayMs, la demande échoue immédiatement avec une erreur informative au lieu d'attendre silencieusement. Réglez-le sur 0 pour désactiver la limite.

Conservez retry.provider.maxRetries à 0 à moins que de nouvelles tentatives au niveau du fournisseur ne soient explicitement nécessaires. Le définir au-dessus de 0 peut faire en sorte que SDK/les tentatives du fournisseur traitent les erreurs hors limite d'utilisation avant que Pi ne les voient, ce qui peut bloquer l'agent jusqu'à ce que le quota du fournisseur soit réinitialisé dans certaines circonstances.

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

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

npmCommand est utilisé pour toutes les npm opérations du gestionnaire de packages, y compris les installations, les désinstallations et les installations de dépendances à l'intérieur des packages git. Les packages npm à l'échelle de l'utilisateur sont installés sous ~/.pi/agent/npm/; Les packages npm à l'échelle du projet sont installés sous .pi/npm/. Utilisez les entrées de style argv exactement comme le processus doit être lancé. Lorsque npmCommand est configuré, les installations de dépendances de packages git utilisent plain install pour éviter les indicateurs spécifiques à npm dans les wrappers ou les gestionnaires de packages alternatifs.

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

Lorsque plusieurs sources spécifient un répertoire de session, la priorité est --session-dir, PI_CODING_AGENT_SESSION_DIR, puis sessionDir dans settings.json.

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

Ces paramètres définissent où charger les extensions, les compétences, les invites et les thèmes.

Les chemins en ~/.pi/agent/settings.json se résolvent par rapport à ~/.pi/agent. Les chemins dans .pi/settings.json se résolvent par rapport à .pi. Les chemins absolus et ~ sont pris en charge.

Les tableaux prennent en charge les modèles globaux et les exclusions. Utilisez !pattern pour exclure. Utilisez +path pour forcer l'inclusion d'un chemin exact et -path pour forcer l'exclusion d'un chemin exact.

Le formulaire de chaîne charge toutes les ressources d'un package:

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

Le formulaire d'objet filtre les ressources à charger:

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

Voir packages.md pour les détails de gestion des packages.

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

Les paramètres du projet (.pi/settings.json) remplacent les paramètres globaux. Les objets imbriqués sont fusionnés:

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