Ajustes

Pi utiliza archivos de configuración JSON con la configuración del proyecto anulando la configuración global.

Edite directamente o use /settings para opciones comunes.

En el inicio interactivo, pi pregunta antes de confiar en una carpeta de proyecto que contiene configuraciones, recursos o proyecto local del proyecto .agents/skills y no tiene ninguna decisión guardada para la carpeta o una carpeta principal en ~/.pi/agent/trust.json. Confiar en un proyecto permite a pi cargar recursos .pi/settings.json y .pi, instalar paquetes de proyecto faltantes y ejecutar extensiones de proyecto.

Los modos no interactivos (-p, --mode json y --mode rpc) no muestran un mensaje de confianza. Sin una decisión de confianza guardada aplicable, usan defaultProjectTrust de la configuración global: ask (predeterminado) y never ignoran esos recursos del proyecto, mientras que always confía en ellos. Pase --approve/-a o --no-approve/-na para anular la confianza del proyecto durante una ejecución.

Si no se aplica ninguna extensión o decisión guardada, defaultProjectTrust controla el comportamiento de reserva. Configúrelo en "ask", "always" o "never" en ~/.pi/agent/settings.json, o cámbielo con /settings.

Los comandos pi config y del paquete usan el mismo flujo de confianza del proyecto, excepto que pi update nunca lo solicita. Pase --approve para confiar en la configuración local del proyecto para un comando o --no-approve para ignorarlos.

Utilice /trust en modo interactivo para guardar una decisión de confianza del proyecto para sesiones futuras, incluida la confianza para la carpeta principal inmediata. Escribe solo ~/.pi/agent/trust.json; la sesión actual no se recarga, así que reinicie pi para que los cambios surtan efecto.

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

Para VS Code, incluya --wait para que pi se reanude después de que salga el editor:

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

enableInstallTelemetry solo controla el ping anónimo de instalación/actualización a https://pi.dev/api/report-install. La exclusión voluntaria de la telemetría no deshabilita las comprobaciones de actualizaciones; Pi aún puede recuperar https://pi.dev/api/latest-version para buscar la última versión.

Configure PI_SKIP_VERSION_CHECK=1 para deshabilitar la verificación de actualización de la versión Pi. Utilice --offline o PI_OFFLINE=1 para deshabilitar todas las operaciones de red de inicio que se describen aquí, incluidas las comprobaciones de actualización, las comprobaciones de actualización de paquetes y la telemetría de instalación/actualización.

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

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

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

Cuando un proveedor solicita un retraso de reintento superior a retry.provider.maxRetryDelayMs, la solicitud falla inmediatamente con un error informativo en lugar de esperar en silencio. Configúrelo en 0 para desactivar el límite.

Mantenga retry.provider.maxRetries en 0 a menos que se necesiten explícitamente reintentos a nivel de proveedor. Configurarlo por encima de 0 puede hacer que SDK/los reintentos del proveedor manejen errores de límite de uso antes de que Pi los vea, lo que puede bloquear al agente hasta que se restablezca la cuota del proveedor en algunas circunstancias.

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

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

npmCommand se usa para todas las operaciones del administrador de paquetes npm, incluidas instalaciones, desinstalaciones e instalaciones de dependencia dentro de paquetes git. Los paquetes npm de ámbito de usuario se instalan en ~/.pi/agent/npm/; Los paquetes npm con alcance de proyecto se instalan en .pi/npm/. Utilice entradas de estilo argv exactamente como se debe iniciar el proceso. Cuando se configura npmCommand, las instalaciones de dependencia de paquetes git usan install simple para evitar indicadores específicos de npm en contenedores o administradores de paquetes alternativos.

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

Cuando varias fuentes especifican un directorio de sesión, la prioridad es --session-dir, PI_CODING_AGENT_SESSION_DIR y luego sessionDir en settings.json.

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

Estas configuraciones definen desde dónde cargar extensiones, habilidades, indicaciones y temas.

Las rutas en ~/.pi/agent/settings.json se resuelven en relación con ~/.pi/agent. Las rutas en .pi/settings.json se resuelven en relación con .pi. Se admiten rutas absolutas y ~.

Las matrices admiten patrones globales y exclusiones. Utilice !pattern para excluir. Utilice +path para forzar la inclusión de una ruta exacta y -path para forzar la exclusión de una ruta exacta.

El formulario de cadena carga todos los recursos de un paquete:

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

El formulario de objeto filtra qué recursos cargar:

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

Consulte packages.md para obtener detalles sobre la administración de paquetes.

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

La configuración del proyecto (.pi/settings.json) anula la configuración global. Los objetos anidados se fusionan:

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