Configuración

Referencia de configuracion

Referencia completa de todas las opciones de configuracion de YeePilot en config.yaml

Última actualización: 1 de marzo de 2026

Archivo de configuracion

YeePilot almacena su configuracion en ~/.yeepilot/config.yaml. Este archivo se crea automaticamente durante la configuracion inicial y puede editarse manualmente o a traves del comando yeepilot setup.

yaml

# Ejemplo de configuracion minima
ai:
  provider: openai
  model: gpt-4o
 
security:
  mode: strict
 
personality:
  language: en

Para regenerar su configuracion con valores predeterminados, ejecute:

bash

yeepilot setup --reset

Ajustes de IA

La seccion ai: controla que proveedor y modelo de IA usa YeePilot y como interactua con el modelo de lenguaje.

yaml

ai:
  provider: openai
  model: gpt-4o
  api_key: ""
  base_url: ""
  max_tokens: 4096
  token_mode: normal
  conversation_max_history: 10
  output_truncate_length: 500
  max_response_length: 102400
  engine: v2
  autonomy_profile: guarded
  think_mode: "off"
  agent_mode: false

provider

El backend de IA a usar. Valores soportados: openai, anthropic, openrouter.

yaml

ai:
  provider: openai

model

El identificador de modelo especifico. Debe ser un ID de modelo valido para su proveedor elegido.

Proveedor	Modelos de ejemplo
openai	`gpt-4o`, `gpt-4o-mini`, `o3-mini`
anthropic	`claude-sonnet-4-20250514`, `claude-haiku-4-20250414`
openrouter	`openai/gpt-4o`, `anthropic/claude-sonnet-4-20250514`

api_key

Su clave API para el proveedor configurado. Aunque puede establecerla aqui, se recomienda usar el llavero del SO a traves de yeepilot setup --auth o variables de entorno para mayor seguridad.

yaml

ai:
  api_key: "sk-..."

base_url

Anule el endpoint de API predeterminado. Util para proxies, modelos locales o servicios alternativos compatibles con la API.

yaml

ai:
  provider: openai
  base_url: "http://localhost:11434/v1"

max_tokens

Numero maximo de tokens que la IA puede generar por respuesta. Predeterminado: 4096.

yaml

ai:
  max_tokens: 8192

token_mode

Controla cuan agresivamente YeePilot gestiona el uso de tokens. Predeterminado: normal.

normal -- Contexto completo y respuestas detalladas.
saver -- Prompts de sistema mas cortos, historial comprimido, compactacion de contexto mas agresiva. Reduce significativamente los costos.

yaml

ai:
  token_mode: saver

conversation_max_history

Numero de mensajes anteriores a retener en el contexto de la conversacion. Predeterminado: 10. Valores mas bajos reducen el uso de tokens y mantienen a la IA enfocada en tareas recientes.

yaml

ai:
  conversation_max_history: 10

output_truncate_length

Numero maximo de caracteres de la salida de comandos a incluir en el contexto de la IA. Predeterminado: 500. Evita que salidas grandes consuman su presupuesto de tokens.

yaml

ai:
  output_truncate_length: 500

max_response_length

Limite estricto del tamano de respuesta de la IA en bytes. Predeterminado: 102400 (100 KB).

yaml

ai:
  max_response_length: 102400

engine

La version del motor de ejecucion. Predeterminado: v2.

v2 -- Motor actual con bucle de agente, llamadas a herramientas y ejecucion de multiples pasos.
legacy -- Generacion de comandos de un solo turno sin llamadas a herramientas.

yaml

ai:
  engine: v2

autonomy_profile

Controla cuanta libertad tiene la IA para ejecutar comandos sin pedir confirmacion. Predeterminado: guarded.

high -- Ejecuta automaticamente comandos SAFE y MODERATE. Solo los comandos DANGEROUS requieren confirmacion.
guarded -- Ejecuta automaticamente comandos SAFE. Los comandos MODERATE y DANGEROUS requieren confirmacion.
strict_review -- Cada comando requiere confirmacion explicita antes de la ejecucion, independientemente del nivel de riesgo.

yaml

ai:
  autonomy_profile: guarded

think_mode

Habilita el razonamiento extendido para proveedores que lo soportan (Anthropic, modelos de razonamiento de OpenAI). Predeterminado: off.

off -- Sin pensamiento extendido.
on -- Habilitar pensamiento con presupuesto predeterminado del proveedor.
low -- Presupuesto de pensamiento minimo.
medium -- Presupuesto de pensamiento moderado para tareas complejas.
high -- Presupuesto de pensamiento maximo para los problemas mas dificiles.

yaml

ai:
  think_mode: medium

Tambien puede alternar esto durante una sesion con el comando slash /think.

agent_mode

Habilita el bucle de agente de IA, permitiendo a la IA encadenar multiples llamadas a herramientas y comandos para completar tareas complejas. Predeterminado: false.

yaml

ai:
  agent_mode: true

Ajustes de seguridad

La seccion security: controla las verificaciones de seguridad de comandos, requisitos de confirmacion y registro de auditoria.

yaml

security:
  mode: strict
  require_confirmation: true
  blocked_patterns:
    - "rm -rf /"
    - "mkfs"
    - "dd if=/dev/zero"
  audit_log_path: "~/.yeepilot/audit.log"
  audit_max_size_mb: 10
  audit_max_archives: 50

mode

La postura de seguridad general. Predeterminado: strict.

strict -- Seguridad maxima. Los comandos mas destructivos se bloquean por completo. Recomendado para servidores de produccion.
moderate -- Seguridad equilibrada. Los comandos destructivos requieren confirmacion pero no se bloquean.
permissive -- Restricciones minimas. Solo los comandos mas peligrosos (por ejemplo, borrar discos) se bloquean. Adecuado solo para entornos de desarrollo aislados.

yaml

security:
  mode: strict

require_confirmation

Si solicitar confirmacion antes de ejecutar comandos. Predeterminado: true. Cuando se establece en false, el perfil de autonomia determina que comandos se ejecutan automaticamente.

yaml

security:
  require_confirmation: true

blocked_patterns

Patrones de comandos adicionales a bloquear por completo. Se agregan sobre la lista de bloqueo integrada de mas de 70 patrones peligrosos de YeePilot.

yaml

security:
  blocked_patterns:
    - "shutdown"
    - "reboot"
    - "halt"
    - "init 0"

audit_log_path

Ruta del archivo para el registro de auditoria resistente a manipulaciones. Predeterminado: ~/.yeepilot/audit.log.

yaml

security:
  audit_log_path: "/var/log/yeepilot/audit.log"

audit_max_size_mb

Tamano maximo de un solo archivo de registro de auditoria antes de la rotacion. Predeterminado: 10 MB.

yaml

security:
  audit_max_size_mb: 10

audit_max_archives

Numero de archivos de registro de auditoria rotados a retener. Predeterminado: 50.

yaml

security:
  audit_max_archives: 50

Ajustes del sandbox

La seccion sandbox: configura el aislamiento de ejecucion de comandos. Los ajustes del sandbox limitan lo que los comandos pueden hacer para proteger su sistema.

yaml

sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64
  denied_paths:
    - "/etc/shadow"
    - "/root/.ssh"

enabled

Habilitar o deshabilitar el sandbox de ejecucion. Predeterminado: true. Deshabilitarlo elimina todos los limites de ejecucion.

yaml

sandbox:
  enabled: true

use_namespaces

Usar namespaces del kernel de Linux para aislamiento completo de procesos (usuario, PID, montaje, red). Predeterminado: true. Solo disponible en Linux. Recurre a limites a nivel de proceso en macOS y Windows.

yaml

sandbox:
  use_namespaces: true

network_access

Permitir que los comandos accedan a la red. Predeterminado: true. Establezca en false para aislar completamente la ejecucion de comandos de la red.

yaml

sandbox:
  network_access: false

max_cpu_seconds

Tiempo maximo de CPU que un solo comando puede consumir. Predeterminado: 300 segundos (5 minutos).

yaml

sandbox:
  max_cpu_seconds: 300

max_memory_mb

Memoria maxima que un comando puede usar. Predeterminado: 512 MB.

yaml

sandbox:
  max_memory_mb: 512

max_filesize_mb

Tamano maximo de cualquier archivo individual que un comando puede crear. Predeterminado: 100 MB.

yaml

sandbox:
  max_filesize_mb: 100

max_processes

Numero maximo de procesos hijos que un comando puede generar. Predeterminado: 64.

yaml

sandbox:
  max_processes: 64

denied_paths

Rutas de archivos que los comandos no tienen permitido leer ni escribir. Se agregan sobre las rutas protegidas integradas.

yaml

sandbox:
  denied_paths:
    - "/etc/shadow"
    - "/etc/passwd"
    - "/root/.ssh"
    - "/home/*/.ssh/id_*"

Ajustes de personalidad

La seccion personality: controla como YeePilot se comunica con usted.

yaml

personality:
  tone: casual
  language: en
  use_emoji: true
  verbosity: normal

tone

El tono conversacional de las respuestas de la IA. Predeterminado: casual.

casual -- Respuestas amigables y conversacionales.
professional -- Respuestas formales y concisas. Bueno para entornos de trabajo.
minimal -- Explicaciones minimas. Solo los comandos y resultados.

yaml

personality:
  tone: professional

language

Idioma para la interfaz y las respuestas de IA de YeePilot. Predeterminado: en.

en -- Ingles
de -- Aleman (Deutsch)
auto -- Detectar desde la configuracion regional del sistema

yaml

personality:
  language: auto

use_emoji

Incluir emoji en las respuestas de la IA y mensajes de estado. Predeterminado: true.

yaml

personality:
  use_emoji: false

verbosity

Cuanto detalle incluye la IA en las respuestas. Predeterminado: normal.

brief -- Explicaciones cortas y directas.
normal -- Explicaciones equilibradas con contexto.
detailed -- Explicaciones detalladas con informacion de fondo.

yaml

personality:
  verbosity: detailed

Ajustes de la TUI

La seccion tui: personaliza la apariencia y comportamiento de la interfaz de usuario de terminal.

yaml

tui:
  theme: auto
  stats_panel: true
  code_line_numbers: true
  live_stream_panel_enabled: true
  live_stream_panel_height: 12

theme

Tema de color para la interfaz de terminal. Predeterminado: auto (coincide con el fondo del terminal).

Temas disponibles: auto, dark, light, neon y mas.

yaml

tui:
  theme: neon

stats_panel

Mostrar el panel de estadisticas con uso de tokens, costo e informacion de sesion. Predeterminado: true.

yaml

tui:
  stats_panel: true

code_line_numbers

Mostrar numeros de linea en bloques de codigo mostrados en la TUI. Predeterminado: true.

yaml

tui:
  code_line_numbers: true

live_stream_panel_enabled

Mostrar un panel en vivo que transmite la salida de comandos en tiempo real mientras se ejecutan. Predeterminado: true.

yaml

tui:
  live_stream_panel_enabled: true

live_stream_panel_height

Numero de lineas para el panel de transmision en vivo. Predeterminado: 12.

yaml

tui:
  live_stream_panel_height: 16

Ajustes de la boveda

La seccion vault: configura la boveda de credenciales cifrada para almacenar secretos como contrasenas de bases de datos y tokens de API.

yaml

vault:
  enabled: true
  start_locked: true
  auto_lock_duration: "15m"
  bruteforce_protection_enabled: true

enabled

Habilitar la funcion de boveda cifrada. Predeterminado: true.

yaml

vault:
  enabled: true

start_locked

Si la boveda debe estar bloqueada cuando YeePilot se inicia, requiriendo que la desbloquee. Predeterminado: true.

yaml

vault:
  start_locked: true

auto_lock_duration

Bloquear automaticamente la boveda despues de esta duracion de inactividad. Predeterminado: 15m. Soporta formato de duracion de Go (por ejemplo, 5m, 1h, 30s).

yaml

vault:
  auto_lock_duration: "30m"

bruteforce_protection_enabled

Habilitar proteccion contra fuerza bruta que limita los intentos de desbloqueo despues de fallos repetidos. Predeterminado: true.

yaml

vault:
  bruteforce_protection_enabled: true

Ajustes de plataforma

La seccion platform: configura la conectividad al servicio de plataforma de YeePilot.

yaml

platform:
  server_url: "https://yee.to"

server_url

La URL del servidor de plataforma de YeePilot. Predeterminado: https://yee.to. Solo cambie esto si esta usando una instancia de plataforma autoalojada.

yaml

platform:
  server_url: "https://yee.to"

Ajustes de actualizacion

La seccion update: controla el comportamiento de actualizacion automatica.

yaml

update:
  auto_check: true
  check_interval_hours: 1

auto_check

Verificar automaticamente actualizaciones cuando YeePilot se inicia. Predeterminado: true.

yaml

update:
  auto_check: true

check_interval_hours

Con que frecuencia verificar actualizaciones, en horas. Predeterminado: 1.

yaml

update:
  check_interval_hours: 24

Ajustes de archivos

La seccion files: controla el comportamiento del comando /file para subir archivos como contexto de IA.

yaml

files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288
  upload_dir: ""

max_entries

Numero maximo de archivos que se pueden adjuntar a una sesion. Predeterminado: 20.

yaml

files:
  max_entries: 20

max_file_size

Tamano maximo de un solo archivo en bytes. Predeterminado: 102400 (100 KB).

yaml

files:
  max_file_size: 102400

max_total

Tamano total maximo de todos los archivos adjuntos en bytes. Predeterminado: 524288 (512 KB).

yaml

files:
  max_total: 524288

upload_dir

Directorio personalizado para subidas temporales de archivos. Deje vacio para usar el predeterminado del sistema.

yaml

files:
  upload_dir: "/tmp/yeepilot-files"

Ejemplo de configuracion completa

A continuacion se muestra un archivo de configuracion completo con todas las secciones y valores comunmente ajustados:

yaml

ai:
  provider: openai
  model: gpt-4o
  max_tokens: 4096
  token_mode: normal
  conversation_max_history: 10
  output_truncate_length: 500
  max_response_length: 102400
  engine: v2
  autonomy_profile: guarded
  think_mode: "off"
  agent_mode: false
 
security:
  mode: strict
  require_confirmation: true
  blocked_patterns: []
  audit_log_path: "~/.yeepilot/audit.log"
  audit_max_size_mb: 10
  audit_max_archives: 50
 
sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64
  denied_paths: []
 
personality:
  tone: casual
  language: en
  use_emoji: true
  verbosity: normal
 
tui:
  theme: auto
  stats_panel: true
  code_line_numbers: true
  live_stream_panel_enabled: true
  live_stream_panel_height: 12
 
vault:
  enabled: true
  start_locked: true
  auto_lock_duration: "15m"
  bruteforce_protection_enabled: true
 
platform:
  server_url: "https://yee.to"
 
update:
  auto_check: true
  check_interval_hours: 1
 
files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288

Boveda de credenciales

Security

Variables de entorno

Configuration