Permissões em agentes de programação: modos e regras allow/deny
O OHarness confere cada chamada de ferramenta com as regras allow, ask e deny e depois com um modo de permissão. deny vence tudo — inclusive o modo bypass —, então uma recusa explícita é a única fronteira em que você pode confiar.
Atualizado em
Os cinco modos
| Modo | Comportamento |
|---|---|
default (Manual) | Pergunta antes de qualquer ação que mude algo |
acceptEdits | Edições de arquivos passam, todo o resto pergunta |
plan | Somente leitura; toda mudança é recusada |
auto | Edições e comandos rotineiros passam, os arriscados perguntam |
bypassPermissions | Aprova tudo — exceto o que uma regra deny proíbe |
Escolha um com /mode em uma sessão ou com --permission-mode na linha de comando. O auto é um julgamento sobre custo, não uma verificação de segurança: ele mede o raio de estrago (rm, sudo, git push, kubectl, npm publish, gravações fora do projeto) e pergunta sobre qualquer coisa que não reconheça como rotina.
Regras
As regras correspondem ao nome da ferramenta, ou a uma forma Tool(argument) com curingas:
{
"allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
"ask": ["Bash(git push*)"],
"deny": ["Bash(rm -rf *)", "write(.env*)"]
}Onde ficam as regras
| Escopo | Arquivo | Para |
|---|---|---|
| user | ~/.oharness/settings.json | Um hábito pessoal |
| project | .oharness/settings.json | Pertence ao repositório, pode ser revisado |
| local | .oharness/settings.local.json | Só esta cópia de trabalho, no gitignore |
As negações se acumulam entre escopos e nunca são sobrescritas, então um projeto pode proibir o que um usuário permitiu globalmente. “Sempre permitir” em um pedido de permissão grava o padrão mais específico — aprovar Bash(npm test) não libera todo Bash(...). O /permissions mostra as regras em vigor.
O que um sistema de permissões não é
A verificação de diretórios graváveis (workspaceMode) recusa caminhos fora do projeto antes de perguntar, mas ela inspeciona argumentos; não confina o processo. Um comando de shell alcança tudo o que você alcança. Para isolamento real, rode o agente em um contêiner ou VM e trate as regras como proteção contra erros.
Perguntas frequentes
Como impedir que um agente de programação execute comandos perigosos?
Adicione regras deny. No OHarness, uma regra como "deny": ["Bash(rm -rf *)", "Bash(git push*)"] recusa esses comandos em todos os modos, inclusive o bypassPermissions. As regras deny são a fronteira; os modos são conveniência.
O modo bypass ignora as regras deny?
Não. No OHarness, deny vence tudo, inclusive o bypassPermissions. Uma recusa explícita é a única regra em que o usuário pode confiar totalmente.
Um repositório pode definir permissões para todos que o usam?
Sim. As regras em .oharness/settings.json vão no commit junto com o projeto. Negações de qualquer escopo se acumulam, então um projeto pode proibir algo mesmo que um usuário tenha permitido globalmente.