zn-gate para o OpenCode

Instale o zn-gate para o OpenCode: um pequeno plugin que bloqueia a leitura de arquivos .env com valores e de arquivos de credenciais, remove segredos da saída de todas as ferramentas e bloqueia segredos colados nos prompts.

Ver .md

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 opencode

O zn-gate instala um pequeno plugin do OpenCode. Depois, reinicie o OpenCode.

O que você recebe

  • Leituras de arquivos .env com valores, de arquivos de credenciais e de ~/.zn são bloqueadas em todas as ferramentas.
  • A saída de cada ferramenta tem os segredos removidos antes de o modelo vê-la, e a prévia na interface do terminal também.
  • Um segredo colado em um prompt é bloqueado (o OpenCode mostra como erro).
  • Se o plugin do zn não puder ser executado, as chamadas e as mensagens são bloqueadas.

Limites

  • Não testado no Windows.
  • O zn-gate check confirma as regras do zn para o OpenCode, mas não inicia o OpenCode.

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 OpenCode. O que a saída significa.