zn-gate para o Cursor

Instale os hooks do zn para o Cursor: eles bloqueiam a leitura de arquivos .env com valores e de arquivos de credenciais, segredos colados nos prompts e chamadas MCP que carregam um segredo.

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 cursor

Depois, reinicie o Cursor.

O que você recebe

  • Leituras de arquivos e leituras pelo shell de arquivos .env com valores e de arquivos de credenciais são bloqueadas.
  • Um segredo colado em um prompt é bloqueado.
  • Chamadas MCP que carregam um valor secreto são bloqueadas.

Limites

  • A saída do shell e o conteúdo dos arquivos não têm segredos removidos; só a saída do MCP tem.
  • A proteção de escrita é feita com o melhor esforço possível.
  • Se o hook do zn travar, leituras e prompts são bloqueados; os demais eventos rodam sem verificação.
  • Não testado no Windows.

Para verificar também os servidores MCP que você usa no Cursor, veja Cursor.

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