Confira se funciona

Depois de instalar o zn-gate para o seu agente de programação, abra um novo terminal e execute:

npx -y zn-gate check

(ou zn-gate check, se você instalou com npm install -g zn-gate).

O que ele faz

O zn-gate cria uma pasta temporária com dois arquivos: um arquivo .env com uma chave falsa e um README.txt comum. Para cada agente configurado para o seu usuário, ele pede ao hook do zn que deixe o agente ler cada arquivo, do mesmo jeito que o agente faria. Um agente só é considerado protegido quando o arquivo .env é bloqueado e o arquivo comum é permitido.

• Claude Code: o zn-gate verifica o plugin do zn-gate ou os hooks de zn hooks install claude-code. Também percebe quando o plugin está desativado e quando uma configuração do Claude Code desliga os hooks.
• Codex CLI e Cursor: o zn-gate verifica os hooks de zn hooks install.
• O que ele executa: para o Claude Code, o Codex CLI e o Cursor, ele executa o hook instalado, exatamente como o seu agente faria. Um hook que não consegue iniciar, ou que bloqueia todos os arquivos porque parte do zn está faltando, é informado como NOT protected. No Windows, um hook instalado como zn hook <agent> não é iniciado; o zn-gate verifica as regras do zn para ele e informa isso.
• O que ele deixa de lado: ele verifica a configuração do seu usuário. Uma configuração feita para um único projeto aparece na lista, mas não é executada.
• Nada muda: nada é enviado pela rede, nenhum agente é iniciado e nenhuma configuração muda. A pasta é apagada no final.

O que você vai ver

zn-gate check: does zn stop your coding agent from reading a secret?

  OK Claude Code  blocked the .env file and allowed the ordinary file. Your agent would be told:
     "zn: ..."
  -  Codex CLI    zn is not set up for this agent. To protect it, run `zn hooks install codex` in your own terminal.
  ...

Your agent cannot read secret files such as .env through these tools. Nothing was sent anywhere.

• OK: o zn está protegendo esse agente. O texto entre aspas é o que o agente recebe quando tenta ler o arquivo.
• -: o zn não está configurado para esse agente, ou só para um projeto. A linha traz o comando que o configura para o seu usuário.
• X ... NOT protected: o zn está configurado, mas não protegeria o agente. A linha diz o motivo e o que executar para corrigir.

zn-gate check termina com código 0 somente quando todos os agentes configurados para o seu usuário estão protegidos.

Se o seu agente precisar de um valor do .env

O zn bloqueia o arquivo porque ele tem valores secretos. Para deixar o agente usá-los sem vê-los, mova os valores para o cofre do zn:

zn env shadow .env

O arquivo passa a ter marcadores como __ZN_API_KEY__ no lugar dos valores, e o zn coloca os valores reais de volta apenas nos comandos que você permitir. Mais: o cofre.

Relacionados

• zn-gate test executa o autoteste de regras embutido do zn (51 exemplos). Ele verifica as regras, não a configuração do seu agente.
• zn-gate status mostra o que a sua configuração envia pela rede (nada, a menos que você tenha ativado a verificação opcional na nuvem).