Permisos de un agente de código: modos y reglas allow y deny
OHarness comprueba cada llamada a herramienta con las reglas allow, ask y deny y después con un modo de permisos. deny gana a todo —incluido el modo bypass—, así que una denegación explícita es el único límite en el que puedes confiar.
Actualizado el
Los cinco modos
| Modo | Comportamiento |
|---|---|
default (Manual) | Pregunta antes de cualquier cosa que cambie el estado |
acceptEdits | Las ediciones de archivos pasan; todo lo demás pregunta |
plan | Solo lectura; se rechaza cualquier cambio |
auto | Las ediciones y los comandos rutinarios pasan; los arriesgados preguntan |
bypassPermissions | Lo aprueba todo, salvo lo que prohíba una regla deny |
Elige uno con /mode en una sesión o con --permission-mode en la línea de comandos. auto es un juicio sobre el coste, no un control de seguridad: mide el radio de impacto (rm, sudo, git push, kubectl, npm publish, escrituras fuera del proyecto) y pregunta por cualquier cosa que no reconozca como rutinaria.
Reglas
Las reglas coinciden con el nombre de la herramienta, o con una forma Tool(argument) con comodines:
{
"allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
"ask": ["Bash(git push*)"],
"deny": ["Bash(rm -rf *)", "write(.env*)"]
}Dónde se guardan las reglas
| Ámbito | Archivo | Para |
|---|---|---|
| user | ~/.oharness/settings.json | Un hábito personal |
| project | .oharness/settings.json | Pertenece al repositorio y se puede revisar |
| local | .oharness/settings.local.json | Solo esta copia de trabajo, en gitignore |
Las denegaciones se acumulan entre ámbitos y nunca se anulan, así que un proyecto puede prohibir lo que un usuario permitió de forma global. «Permitir siempre» en una solicitud de permiso escribe el patrón más específico: aprobar Bash(npm test) no concede todos los Bash(...). /permissions muestra las reglas en vigor.
Lo que no es un sistema de permisos
La comprobación de raíces con permiso de escritura (workspaceMode) rechaza rutas fuera del proyecto antes de preguntar, pero inspecciona argumentos; no confina el proceso. Un comando de shell puede llegar a todo lo que llegas tú. Para un confinamiento real, ejecuta el agente en un contenedor o una máquina virtual y trata las reglas como una protección contra errores.
Preguntas frecuentes
¿Cómo impido que un agente de código ejecute comandos peligrosos?
Añade reglas deny. En OHarness, una regla como "deny": ["Bash(rm -rf *)", "Bash(git push*)"] rechaza esos comandos en todos los modos, incluido bypassPermissions. Las reglas deny son el límite; los modos son una comodidad.
¿El modo bypass ignora las reglas deny?
No. En OHarness, deny gana a todo, incluido bypassPermissions. Una denegación explícita es la única regla en la que un usuario puede confiar por completo.
¿Un repositorio puede fijar permisos para todos los que lo usan?
Sí. Las reglas de .oharness/settings.json se confirman con el proyecto. Las denegaciones de cualquier ámbito se acumulan, así que un proyecto puede prohibir algo aunque un usuario lo haya permitido de forma global.