Asegurar un agente: seguridad, permisos y carpetas de confianza
En esta página
Lección reescrita el 2 de noviembre de 2026. La versión anterior describía el campo
safetycomo un nivel de permiso. La documentación de Vibe es explícita: se trata de un indicador visual que colorea el borde del campo de entrada; no impone restricción alguna. La protección real proviene de las listas de herramientas, los permisos por herramienta y las carpetas de confianza. Fuentes: Safety, approvals, and permissions · Configuration reference.
Qué hace (y qué no hace) safety
El campo safety en un archivo de agente acepta cinco valores: safe, neutral (el predeterminado), destructive, smart y yolo. Cambia el color del borde del área de entrada para ofrecerte un recordatorio visual instantáneo del agente que estás utilizando. No elimina herramientas ni activa solicitudes de aprobación. Un agente marcado como safe pero equipado con bash sin restricciones puede seguir ejecutando comandos destructivos.
Existe una excepción: cuando un administrador desactiva la aprobación automática (enable_auto_approve = false), Vibe oculta todos los agentes marcados como yolo. Por lo demás, safety es una etiqueta, no un candado. Combínalo siempre con los controles reales que se detallan a continuación.
Primera palanca: herramientas disponibles
enabled_tools (lista de permitidos) y disabled_tools (lista de denegados, aplicada posteriormente) deciden qué puede invocar el agente. Aceptan nombres exactos, patrones glob y expresiones regulares con el prefijo re:.
# Agente de auditoría de solo lectura
display_name = "Security Audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]
Si una herramienta no está en la lista, no existe para ese agente. Esta es tu garantía más sólida.
Segunda palanca: permisos por herramienta
Para las herramientas disponibles, un bloque [tools.<tool>] establece la regla: "always" (sin pregunta), "ask" (preguntar cada vez) o "never" (bloquear).
display_name = "Refactoring"
safety = "neutral"
enabled_tools = ["read_file", "grep", "edit", "write_file", "bash"]
[tools.edit]
permission = "always"
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pnpm test"]
denylist = ["rm -rf", "git push"]
Para bash, allowlist y denylist especifican prefijos de comando que siempre están permitidos o siempre denegados. Vibe permite algunos comandos de solo lectura por defecto (ls, pwd, cat, git status, etc.), pero cualquier lista que escribas reemplaza la lista predeterminada: incluye cualquier comando por defecto que quieras mantener. Para read_file, write_file y edit, estas listas aceptan patrones de ruta absoluta. Una regla prudente: un script ejecutado mediante bash puede construir rutas que Vibe no ve en el propio comando; mantén bash configurado como "ask" siempre que las consecuencias lo justifiquen.
Tercera palanca: alcance del directorio de trabajo
Por defecto, Vibe solicita confirmación antes de que una herramienta de archivo o shell acceda a una ruta fuera del directorio de trabajo, incluso mediante un enlace simbólico, y antes de leer o modificar archivos .env y .envrc. Puedes reforzar este comportamiento:
outside_workdir = "deny" # denegar en lugar de preguntar; el agente recibe un error y continúa
Cuarta palanca: carpetas de confianza
Un repositorio puede incluir su propia configuración de Vibe (agentes, habilidades, servidores MCP, permisos) en una carpeta .vibe/, o instrucciones en un archivo AGENTS.md. Dado que esta configuración cambia el comportamiento de Vibe, solo se carga desde una carpeta que hayas aprobado explícitamente. En el primer lanzamiento, Vibe lista los archivos detectados y ofrece Trust folder, Trust full repo o Don’t trust; tus elecciones se guardan en ~/.vibe/trusted_folders.toml. El diálogo no analiza estos archivos: revísalos como cualquier otro código del repositorio, especialmente las definiciones de servidores MCP y los permisos. En modo programático, Vibe nunca pregunta: vibe --trust otorga confianza temporal para una única ejecución.
Responder a una solicitud de aprobación
Cuando Vibe solicita confirmación, hay cuatro respuestas de teclado posibles: 1 o y permite una vez, 2 para el resto de la sesión, 3 siempre, y 4, n o Escape deniega. El color del borde te recuerda qué agente está activo.
Elegir el equilibrio adecuado
| Necesidad | Configuración |
|---|---|
| Analizar sin tocar nada | enabled_tools = ["read_file", "grep"] |
| Refactorizar con confianza | edit establecido en "always", bash en "ask" con una allowlist de comandos de prueba |
| Limpiar un proyecto | bash en "ask" y una denylist de comandos irreversibles |
| Tarea desatendida en CI | Contenedor efímero, vibe --prompt … --auto-approve, límites --max-turns y --time-limit |
La regla de oro sigue siendo el mínimo privilegio: da a cada agente lo estrictamente necesario, comienza con restricciones y abre el acceso solo según sea necesario.
Puntos clave
safety(safe,neutral,destructive,smart,yolo) colorea el borde; no aplica permisos- Candados reales:
enabled_tools/disabled_tools, luego[tools.<tool>](always,ask,never) - Para
bash,allowlistydenylistreemplazan las listas predeterminadas - Vibe pregunta antes de salir del directorio de trabajo o tocar archivos
.env - La configuración del proyecto solo se carga en una carpeta de confianza; revísala antes de aprobar