Instalar el cliente

Instala el cliente en la máquina donde se ejecuta tu agente de código, para que cada acción cubierta se decida antes de ejecutarse. El cliente se instala en el ámbito del usuario y no necesita derechos de administrador. Elige el comando que corresponda a la máquina.

Node.js

En cualquier máquina que ya tenga Node.js:

npx @openlatch/client init

Solo npx necesita Node.js. El cliente en sí es un binario nativo y no se ejecuta sobre Node.js.

macOS y Linux

No requiere ningún runtime:

curl -LsSf https://openlatch.ai/install.sh | sh

Windows

No requiere ningún runtime:

powershell -ExecutionPolicy Bypass -c "irm https://openlatch.ai/install.ps1 | iex"

Cada comando instala la misma versión del cliente desde el registro de npm y luego ejecuta openlatch init, que detecta los agentes de código de la máquina, conecta sus hooks e inicia el cliente.

Registrar la máquina

1. En una máquina donde estás frente a una terminal, openlatch init abre app.openlatch.ai en tu navegador cuando la máquina aún no tiene credencial. Inicia sesión y el cliente guarda la credencial en el llavero del sistema operativo.
2. En una máquina sin nadie frente a la terminal, crea primero una clave de API en la página API Keys de tu cuenta en la consola y defínela en OPENLATCH_API_KEY antes de ejecutar el comando de instalación.
3. Ejecuta openlatch status y comprueba que cada agente aparece con su nivel de control.

Nota

La descarga se verifica con el resumen publicado por el propio registro. Eso detecta corrupción y truncamiento, no un registro comprometido.

Comprobar los hooks

Ejecuta openlatch doctor. Diagnostica la configuración y la conexión con la plataforma y, para todo lo que no está bien, indica la causa y el comando que lo corrige.

Qué cambia la instalación

• Instala solo para tu usuario. No se necesitan derechos de administrador.
• Con un script, coloca dos binarios, openlatch y openlatch-hook, en ~/.local/bin en macOS y Linux, o en %LOCALAPPDATA%\openlatch\bin en Windows, y añade esa carpeta a tu PATH. Puede que una terminal ya abierta tenga que reabrirse una vez.
• Con npx, no se añade nada a tu PATH: el cliente guarda sus binarios en su directorio de estado, así que puede que no se encuentre un openlatch sin más. Ejecuta los comandos siguientes con el mismo comando npx, con el comando que quieras en lugar de init, por ejemplo status.
• Antes de instalar nada, compara un resumen SHA-512 de la descarga con el que el registro publica para esa versión.

Código de salida

Para las herramientas de despliegue que leen el código de salida de un script de instalación:

Código	Significado
0	Instalado y configurado. El resultado aún puede señalar algo que revisar
6	Instalado, pero la configuración no terminó. El resultado en pantalla dice por qué
7	Instalado, a la espera de un agente de IA: la máquina aún no tiene ninguno. Instala uno y vuelve a ejecutar el script
2–5	No se instaló nada utilizable. El script muestra un código OL-21xx que indica el motivo

Plataformas compatibles

Plataforma	Estado
macOS, Apple silicon e Intel	Compatible
Linux con glibc, x86_64 y arm64	Compatible
Windows, x64	Compatible
Linux con musl, como Alpine	No compatible. El script de instalación se detiene e indica el motivo
Windows en ARM64	No compatible. El script de instalación se detiene e indica el motivo

A continuación, escribe tu primera política.