Referencia de configuración

Dónde está la configuración

La configuración principal vive en:

~/.yeepilot/config.yml

Instalaciones antiguas todavía pueden conservar ~/.yeepilot/config.yaml, pero la ruta actual es config.yml.

Cómo cambiarla

Tiene tres formas cómodas:

• usar yeepilot setup
• abrir Settings en el Neural HUD
• editar config.yml manualmente

Prioridad

El orden práctico de prioridad es:

1. variables de entorno
2. ~/.yeepilot/config.yml
3. valores por defecto internos

Sección ai

Aquí controla el comportamiento principal de la IA:

• provider
• model
• base_url
• thinking
• token_mode
• vibe_coding

Ejemplo:

ai:
  provider: openrouter
  model: openai/gpt-oss-120b:free
  thinking: auto
  token_mode: balanced
  vibe_coding: false

Subáreas avanzadas de ai

Algunos equipos también usan:

• ai.recovery para límites de recuperación
• ai.agentic para comportamiento multietapa
• ai.failover para cadena de respaldo entre proveedores o modelos
• ai.knowledge para fuentes de conocimiento
• ai.context7 para contexto adicional
• ai.codeintel para ayudas de navegación o análisis
• ai.verification para reglas de verificación
• ai.scheduler para comportamientos programados

Para usuarios finales, lo importante es ajustar solo lo que entienda y probar cambios pequeños.

Sección security

Controla aprobación, posturas de seguridad y límites sensibles.

Ajustes frecuentes:

• mode
• require_confirmation
• audit

Sección sandbox

La sandbox limita qué puede hacer el runtime local.

Claves habituales:

• enabled
• use_namespaces
• network_access
• max_cpu_seconds
• max_memory_mb
• max_filesize_mb
• max_processes
• denied_paths

Ejemplo:

sandbox:
  enabled: true
  network_access: false
  max_cpu_seconds: 120
  max_memory_mb: 1024

Sección tui

Controla la interfaz de terminal:

• tema
• idioma
• live stream
• sidecar
• comportamiento visual

Los ajustes internos tui.hud.* normalmente es mejor cambiarlos desde el HUD en lugar de editarlos a mano.

Atajos y keybinds

Los usuarios finales deberían gestionar atajos desde la pestaña Keybinds del HUD. La sección tui.keybinds.actions existe, pero editar IDs internos a mano no suele ser la mejor opción.

Sección files

Define cómo maneja YeePilot adjuntos, contexto y archivos locales. Si trabaja con repositorios grandes, aquí conviene revisar límites y comportamiento de inclusión.

Sección vault

Aquí se ajustan bloqueo, autolock y preferencias del Vault. Cambie estas opciones con cuidado porque afectan acceso a secretos y recuperación.

Sección personality

Permite ajustar el tono o el perfil operativo visible para el usuario. Úselo solo si su organización tiene una preferencia clara.

Sección platform

Guarda opciones relacionadas con el entorno donde corre YeePilot. La mayoría de usuarios no necesita tocarla con frecuencia.

Sección update

Controla cómo se buscan y aplican actualizaciones.

Claves útiles:

• auto_check
• check_interval_hours
• channel
• channel_token

Ejemplo:

update:
  auto_check: true
  check_interval_hours: 24
  channel: public

Qué no usar como ajuste principal

Puede encontrar referencias antiguas a ai.agent_mode. Ese ajuste existe solo por compatibilidad y no debería ser su control principal. Para uso moderno, gestione la experiencia con:

• /plan
• /autonomy
• /think
• ai.vibe_coding

Recomendación práctica

• cambie primero desde el HUD o yeepilot setup
• use edición manual solo para ajustes que ya entienda
• pruebe cambios delicados en tareas pequeñas antes de aplicarlos a su flujo diario