zn-gate para o Codex CLI

Você precisa do Node.js 18 ou mais recente. Cole cada linha em um terminal e pressione Enter depois de cada uma:

npm install -g zn-gate
zn hooks install codex

Depois, abra o Codex e aprove os novos hooks com /hooks.

O que você recebe

• Leituras de arquivos .env com valores, de arquivos de credenciais e de ~/.zn são bloqueadas, tanto em comandos de shell quanto em patches (apply_patch).
• A saída das ferramentas tem os segredos removidos antes de o modelo vê-la. O Codex substitui o resultado pelo texto já sem segredos, então o modelo recebe texto em vez do resultado estruturado.
• Um segredo colado em um prompt é bloqueado.
• Para um comando que usa um marcador __ZN_<NAME>__, o Codex recebe a linha exata zn run -- ... a ser usada.

Limites

• O Codex diz que os próprios hooks são "uma barreira de proteção, não um limite de imposição". Se o hook do zn não puder ser executado, o Codex informa a falha e a chamada ou o prompt segue em frente.
• O log da própria sessão do Codex mantém a saída original.
• No Windows, o comando do hook foi executado à mão no PowerShell e no Prompt de Comando, não nos nossos testes automatizados.

Mantenha os valores do seu .env no cofre

O agente não consegue ler arquivos .env com valores reais. Mova os valores para o cofre criptografado do zn-gate, e o arquivo mantém marcadores como __ZN_STRIPE_KEY__:

zn unlock            # cria o cofre na primeira vez
zn env shadow .env

Depois disso, o seu próprio app também lê os marcadores: inicie-o com o comando run do zn-gate depois de permiti-lo. O env shadow mostra como desfazer. Mais: o cofre.

Confira se funciona

Em um novo terminal, execute zn-gate check. Ele deve mostrar OK para o Codex CLI. O que a saída significa.

No PowerShell do Windows, se o npm disser "running scripts is disabled on this system", use npm.cmd e zn.cmd no lugar: veja Instalar.