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

ModoComportamento
default (Manual)Pergunta antes de qualquer ação que mude algo
acceptEditsEdições de arquivos passam, todo o resto pergunta
planSomente leitura; toda mudança é recusada
autoEdições e comandos rotineiros passam, os arriscados perguntam
bypassPermissionsAprova 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

EscopoArquivoPara
user~/.oharness/settings.jsonUm hábito pessoal
project.oharness/settings.jsonPertence ao repositório, pode ser revisado
local.oharness/settings.local.jsonSó 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.

Relacionados