Comprueba que funciona

zn-gate check demuestra que zn impide que tu agente de programación lea un secreto: un archivo .env de prueba con una clave falsa se bloquea y un archivo normal se permite. No se envía nada a ningún sitio.

Ver .md

Tras instalar zn-gate para tu agente de programación, abre una terminal nueva y ejecuta:

npx -y zn-gate check

(o zn-gate check si lo instalaste con npm install -g zn-gate).

Qué hace

zn-gate crea una carpeta temporal con dos archivos: un .env que contiene una clave falsa y un README.txt normal. Para cada agente configurado para tu usuario, pide al hook de zn que deje al agente leer cada archivo, igual que lo haría tu agente. Un agente se considera protegido solo cuando el .env se bloquea y el archivo normal se permite.

  • Claude Code: zn-gate comprueba el plugin de zn-gate o los hooks de zn hooks install claude-code. También detecta cuando el plugin está desactivado y cuando un ajuste de Claude Code desactiva los hooks.
  • Codex CLI y Cursor: zn-gate comprueba los hooks de zn hooks install.
  • Qué ejecuta: para Claude Code, Codex CLI y Cursor ejecuta el hook instalado, exactamente como lo haría tu agente. Un hook que no puede arrancar, o que bloquea todos los archivos porque falta una parte de zn, se indica como X ... NOT protected. En Windows, un hook instalado como zn hook <agent> no se arranca; zn-gate comprueba en su lugar las reglas de zn para él y lo dice.
  • OpenCode: zn-gate comprueba las reglas de zn. El plugin de zn se ejecuta dentro de OpenCode, así que aquí no se arranca.
  • Qué no toca: comprueba la configuración de tu usuario. Una configuración hecha solo para un proyecto aparece en la lista, pero no se ejecuta.
  • Nada cambia: no se envía nada por la red, no se arranca ningún agente y no cambia ningún ajuste. La carpeta se borra al final.

Qué verás

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: zn está protegiendo ese agente. El texto entre comillas es lo que el agente recibe cuando intenta leer el archivo.
  • -: zn no está configurado para ese agente, o solo para un proyecto. La línea indica el comando que lo configura para tu usuario.
  • X ... NOT protected: zn está configurado, pero no protegería al agente. La línea indica el motivo y qué ejecutar para arreglarlo.

zn-gate check termina con código 0 solo si todos los agentes configurados para tu usuario están protegidos.

Si tu agente necesita un valor de .env

zn bloquea el archivo porque contiene valores secretos. Para que tu agente pueda usarlos sin verlos, mueve los valores al almacén de zn:

zn env shadow .env

El archivo conserva marcadores como __ZN_API_KEY__ en lugar de los valores, y zn devuelve los valores reales solo a los comandos que permitas. Más información: el almacén.

Relacionado

  • zn-gate test ejecuta la autoprueba de reglas integrada de zn (51 ejemplos). Comprueba las reglas, no tu configuración de agentes.
  • zn-gate status muestra qué envía tu configuración por la red (nada, salvo que hayas activado la comprobación opcional en la nube).