Installer le client

Installez le client sur la machine où s’exécute votre agent de code, afin que chaque action couverte soit décidée avant son exécution. Le client s’installe au niveau de l’utilisateur, sans droits d’administrateur. Choisissez la commande adaptée à la machine.

Node.js

Sur toute machine où Node.js est déjà installé :

npx @openlatch/client init

Seul npx a besoin de Node.js. Le client lui-même est un binaire natif et ne s’exécute pas sur Node.js.

macOS et Linux

Aucun runtime requis :

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

Windows

Aucun runtime requis :

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

Chaque commande installe la même version du client depuis le registre npm, puis lance openlatch init, qui détecte les agents de code de la machine, raccorde leurs hooks et démarre le client.

Enrôler la machine

1. Sur une machine où vous êtes devant un terminal, openlatch init ouvre app.openlatch.ai dans votre navigateur lorsque la machine n’a pas encore d’identifiant. Connectez-vous, et le client enregistre l’identifiant dans le trousseau du système d’exploitation.
2. Sur une machine sans personne devant le terminal, créez d’abord une clé d’API sur la page API Keys de votre compte dans la console, et définissez-la dans OPENLATCH_API_KEY avant de lancer la commande d’installation.
3. Lancez openlatch status et vérifiez que chaque agent apparaît avec son niveau de contrôle.

Note

Le téléchargement est vérifié par rapport à l’empreinte publiée par le registre. Cela détecte une corruption ou une troncature, pas un registre compromis.

Vérifier les hooks

Lancez openlatch doctor. Il diagnostique la configuration et la connexion à la plateforme et, pour tout ce qui ne va pas, il indique la cause et la commande qui la corrige.

Ce que l’installation modifie

• Elle installe pour votre utilisateur uniquement. Aucun droit d’administrateur n’est nécessaire.
• Avec un script, elle place deux binaires, openlatch et openlatch-hook, dans ~/.local/bin sous macOS et Linux, ou dans %LOCALAPPDATA%\openlatch\bin sous Windows, et ajoute ce dossier à votre PATH. Un terminal déjà ouvert peut devoir être rouvert une fois.
• Avec npx, rien n’est ajouté à votre PATH : le client garde ses binaires dans son répertoire d’état, et un simple openlatch peut ne pas être trouvé. Lancez les commandes suivantes par la même commande npx, avec la commande voulue à la place de init, par exemple status.
• Avant d’installer quoi que ce soit, elle compare une empreinte SHA-512 du téléchargement avec celle que le registre publie pour cette version.

Code de sortie

Pour les outils de déploiement qui lisent le code de sortie d’un script d’installation :

Code	Signification
0	Installé et configuré. Le résultat peut encore signaler un point à examiner
6	Installé, mais la configuration n’a pas abouti. Le résultat à l’écran en donne la raison
7	Installé, en attente d’un agent d’IA : la machine n’en a pas encore. Installez-en un et relancez le script
2–5	Rien d’utilisable n’a été installé. Le script affiche un code OL-21xx qui en donne la raison

Plateformes prises en charge

Plateforme	Statut
macOS, Apple silicon et Intel	Pris en charge
Linux avec glibc, x86_64 et arm64	Pris en charge
Windows, x64	Pris en charge
Linux avec musl, comme Alpine	Non pris en charge. Le script d’installation s’arrête et en donne la raison
Windows sur ARM64	Non pris en charge. Le script d’installation s’arrête et en donne la raison

Ensuite, écrivez votre première politique.