Eine Maschine verbinden.

Der Host

Der Host ist das Programm, das der Werkbank die Dateien dieses Computers und die daran angeschlossenen Maschinen gibt. Es gibt genau einen Host pro Computer. Die Desktop-App ist ein Host; ebenso der Hintergrunddienst, der mit commandagi daemon start gestartet wird. Wenn die Desktop-App startet, übernimmt sie von einem laufenden Dienst.

Der Host hört nur auf 127.0.0.1 (standardmäßig Port 4173 oder ein beliebiger freier Port) und speichert seinen Zustand in ~/.commandagi:

Der Befehl 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 startet den Host im Hintergrund und schreibt das Protokoll nach ~/.commandagi/daemon.log. --no-platform hostet lokal, ohne Verknüpfung mit einem Konto.
• daemon stop verweigert, solange die Desktop-App der Host ist — beenden Sie sie stattdessen in der App.
• mcp ist die stdio-Weiterleitung für Agenten (siehe SDK und MCP). grant erstellt und widerruft Dauerberechtigungen (siehe Agenten und Dauerberechtigungen).
• threed installiert den lokalen 3D-Designdienst; code eval wertet einen Codeteil ohne Oberfläche aus und gibt seinen Operationsgraphen als JSON aus.

Den Host mit Ihrem Konto verknüpfen

Ein Host, der mit einem Konto verknüpft ist, ist von der Werkbank dieses Kontos überall erreichbar und handelt als dieses Konto. Verknüpfen heißt anmelden:

• in der Desktop-App melden Sie sich an, wenn sie danach fragt;
• auf der Werkbankseite, die der Host ausliefert, melden Sie sich im linken Dock an — der Host prüft den Schlüssel und behält ihn;
• aus einer Shell setzen Sie COMMANDAGI_API_KEY auf einen API-Schlüssel, bevor Sie den Daemon starten.

Der Kontoschlüssel wird in host.json gespeichert, einer einfachen Datei, die nur der Eigentümer lesen kann, damit ein kopiertes ~/.commandagi angemeldet bleibt. Abmelden entfernt ihn.

Hosts untereinander koppeln

Hosts auf verschiedenen Computern können sich in beide Richtungen in einem Schritt koppeln: Ein Host bietet an, der andere nimmt an. Das Koppeln ist immer eine Entscheidung einer Person. Nach dem Koppeln können Agenten die anderen Hosts auflisten und aufrufen — im Rahmen der dort bestehenden Berechtigungen.

Seitentreiber: USB und Bluetooth aus dem Browser

Einige Treiber laufen auf der Werkbankseite selbst und nutzen WebSerial und Web Bluetooth. Ein Browser öffnet einen Port nur, wenn Sie ihn auswählen; so nutzt ein Agent immer eine Verbindung, die eine Person hergestellt hat, und öffnet nie selbst eine. Netzwerkmaschinen (die HTTP-API eines Druckers, ein FluidNC-Controller über TCP) werden vom Host gesteuert.

Treiber, die auf Maschinen warten, die sich über das LAN einwählen, brauchen die Einstellung "devices.lanListener": true.

Treiberkatalog

Jeder Treiber sagt, wogegen er geprüft wurde: keine, Loopback (gegen eine getreue Software-Attrappe des Protokolls), Prüfstand oder Hardware. Ein Treiber behauptet nie mehr, als getan wurde. Noch keine Maschine wurde an Hardware in Betrieb genommen.

Simulationswelten verwenden stattdessen zwei Simulatoren: gcode-sim für G-Code-Kanäle und servo-sim für Servobusse.

Weiter

Geben Sie einem Agenten Befugnis über eine Maschine: Agenten und Dauerberechtigungen.