Connecter une machine.

L’hôte

L’hôte est le programme qui donne à l’atelier les fichiers de cet ordinateur et les machines qui y sont reliées. Il y a exactement un hôte par ordinateur. L’application de bureau est un hôte ; le service en arrière-plan, lancé avec commandagi daemon start, en est un aussi. Quand l’application de bureau démarre, elle prend le relais d’un service en cours d’exécution.

L’hôte écoute uniquement sur 127.0.0.1 (port 4173 par défaut, ou tout port libre) et conserve son état dans ~/.commandagi :

La commande commandagi

commandagi daemon start [--port N] [--project DIR] [--name X] [--no-platform]
commandagi daemon status | stop | logs
commandagi daemon run   [same flags, in the foreground]
commandagi mcp [--credential-file F]
commandagi grant add | list | revoke …
commandagi threed install | status
commandagi code eval <path> [--input name=value]…

• daemon start lance l’hôte en arrière-plan et journalise dans ~/.commandagi/daemon.log. --no-platform héberge en local, sans lien vers un compte.
• daemon stop refuse tant que l’application de bureau est l’hôte. Quittez-la depuis l’application.
• mcp est le relais stdio pour les agents (voir SDK et MCP). grant crée et révoque les autorisations permanentes (voir Agents et autorisations permanentes).
• threed installe le service local de conception 3D ; code eval évalue une pièce de code sans interface et affiche son graphe d’opérations en JSON.

Lier l’hôte à votre compte

On peut joindre un hôte lié à un compte depuis l’atelier de ce compte, où qu’il soit, et il agit comme ce compte. Lier, c’est se connecter :

• dans l’application de bureau, connectez-vous quand elle le demande ;
• sur la page de l’atelier servie par l’hôte, connectez-vous depuis le dock gauche : l’hôte vérifie la clé et la conserve ;
• depuis un shell, définissez COMMANDAGI_API_KEY avec une clé d’API avant de lancer le daemon.

La clé de compte est conservée dans host.json, un fichier en clair réservé au propriétaire, afin qu’un ~/.commandagi copié reste connecté. La déconnexion la supprime.

Appairer des hôtes entre eux

Des hôtes sur des ordinateurs différents peuvent s’appairer, dans les deux sens, en un seul geste : un hôte propose, l’autre accepte. L’appairage est toujours une décision d’une personne. Une fois appairés, les agents peuvent lister les autres hôtes et les appeler, dans les limites des autorisations qui existent là-bas.

Pilotes de page : USB et Bluetooth depuis le navigateur

Certains pilotes tournent dans la page de l’atelier elle-même, avec WebSerial et Web Bluetooth. Un navigateur n’ouvre un port que lorsque vous le choisissez : un agent utilise donc toujours une connexion faite par une personne et n’en ouvre jamais une seule. Les machines réseau (l’API HTTP d’une imprimante, un contrôleur FluidNC en TCP) sont pilotées par l’hôte.

Les pilotes qui écoutent les machines qui se connectent par le LAN ont besoin du paramètre "devices.lanListener": true.

Catalogue des pilotes

Chaque pilote indique face à quoi il a été vérifié : none, loopback (face à une imitation logicielle fidèle du protocole), bench ou hardware. Un pilote ne revendique jamais plus que ce qui a été fait. Aucune machine n’a encore été mise en service sur du matériel réel.

Les mondes de simulation utilisent deux simulateurs à la place : gcode-sim pour les canaux G-code et servo-sim pour les bus de servos.

Suite

Donnez à un agent l’autorité sur une machine : Agents et autorisations permanentes.