Host
Host adalah program yang memberi meja kerja akses ke berkas komputer ini dan mesin yang terpasang padanya. Hanya ada satu host per komputer. Aplikasi desktop adalah host, begitu juga layanan latar belakang yang dimulai dengan commandagi daemon start. Saat aplikasi desktop mulai, ia mengambil alih dari layanan yang sedang berjalan.
Host hanya mendengarkan di 127.0.0.1 (port 4173 secara default, atau port bebas mana pun). Host menyimpan statusnya di ~/.commandagi:
| berkas | isinya |
|---|---|
host.json | akun yang ditautkan ke host ini, id-nya, dan pengaturan tautannya (hanya pemilik) |
grants.json | izin tetap yang dibuat di host ini (hanya pemilik) |
principals.json | hash kredensial prinsipal dan kunci akun tepercaya (hanya pemilik) |
mcp.json | endpoint MCP lokal dan token per peluncuran (hanya pemilik) |
daemon.json | proses mana yang menjadi host, dan di port mana |
settings.json, recents.json, devices/, worlds/ | pengaturan tingkat pengguna dan definisi Anda |
daemon.log | log host |
Asalnya dari mana: host dikemas di dalam aplikasi desktop, dan juga berdiri sendiri sebagai paket npm @commandagi/host (npm install -g @commandagi/host, Node 22 atau lebih baru). Perintah commandagi dari paket itu adalah baris perintah host di bawah ini. Paket commandagi di npm hanya berisi SDK; lihat SDK dan MCP.
Perintah 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 startmenjalankan host di latar belakang dan mencatat ke~/.commandagi/daemon.log.--no-platformmen-host secara lokal tanpa menautkan ke akun.daemon stopmenolak selama aplikasi desktop menjadi host. Keluarlah dari aplikasi sebagai gantinya.mcpadalah relai stdio untuk agen (lihat SDK dan MCP).grantmembuat dan mencabut izin tetap (lihat Agen dan izin tetap).threedmemasang layanan desain 3D lokal.code evalmengevaluasi bagian kode secara headless dan mencetak grafik operasinya sebagai JSON.
Tautkan host ke akun Anda
Host yang ditautkan ke akun dapat dijangkau dari meja kerja akun itu di mana saja, dan bertindak sebagai akun itu. Menautkan berarti masuk:
- di aplikasi desktop, masuk saat diminta;
- di halaman meja kerja yang disajikan oleh host, masuk dari dok kiri. Host memeriksa kunci dan menyimpannya;
- dari shell, atur
COMMANDAGI_API_KEYke kunci API sebelum memulai daemon.
Kunci akun disimpan di host.json, berkas biasa yang hanya dapat dibaca pemilik, sehingga salinan ~/.commandagi tetap masuk. Keluar akan menghapusnya.
Pasangkan host satu sama lain
Host di komputer yang berbeda dapat dipasangkan, dua arah, dalam satu tindakan: satu host menawarkan, dan host lain menerima. Memasangkan selalu merupakan keputusan seseorang. Setelah dipasangkan, agen dapat mencantumkan host lain dan memanggilnya, dalam izin apa pun yang ada di sana.
Driver halaman: USB dan Bluetooth dari peramban
Beberapa driver berjalan di halaman meja kerja itu sendiri, menggunakan WebSerial dan Web Bluetooth. Peramban hanya membuka port saat Anda memilihnya. Dengan begitu, agen selalu menggunakan koneksi yang dibuat seseorang dan tidak pernah membuka koneksi sendiri. Mesin jaringan (API HTTP printer, pengendali FluidNC di TCP) dikendalikan oleh host.
Driver yang mendengarkan mesin yang menghubungi melalui LAN memerlukan pengaturan "devices.lanListener": true.
Katalog driver
Setiap driver menyatakan terhadap apa ia telah diverifikasi: none, loopback (terhadap tiruan perangkat lunak yang setia pada protokol), bench atau hardware. Driver tidak pernah mengklaim lebih dari yang telah dilakukan. Belum ada mesin yang dikomisikan pada perangkat keras.
| driver | mesin dan protokol | berjalan di | terverifikasi |
|---|---|---|---|
grbl-serial | GRBL 1.1, serial USB | halaman | loopback |
grbl-tcp | FluidNC / grblHAL, telnet (TCP 23) | host | loopback |
marlin-serial | Marlin, serial USB | halaman | loopback |
smoothie-serial | Smoothieware, serial USB | halaman | loopback |
linuxcnc-rsh | LinuxCNC 2.9 linuxcncrsh (TCP 5007) | host | loopback |
octoprint-http | OctoPrint 1.x | host | loopback |
moonraker-http | Klipper melalui Moonraker | host | loopback |
prusalink-http | PrusaLink | host | loopback |
repetier-http | Repetier-Server | host | loopback |
duet-http | Duet / RepRapFirmware 3.1+ | host | loopback |
feetech-sts-serial | Bus servo Feetech STS/SCS (SO-100/101) | halaman | loopback |
dynamixel2-serial | Dynamixel Protocol 2.0 (Koch, WidowX) | halaman | loopback |
xarm-tcp | UFACTORY xArm / Lite 6 (TCP 502) | host | loopback |
host-relay | Lengan ESP32 CommandAGI, HTTP LAN | host | loopback |
wifi8k-drone | Drone WIFI_8K / E99 melalui tautan ESP32 | halaman | loopback |
ble-hid-relay | Relai BLE HID (ESP32) | halaman | loopback |
openpnp-files | Penyerahan pekerjaan OpenPnP (berkas) | host | loopback |
os-input | keyboard dan penunjuk komputer ini | host | loopback |
cdp-tab | sebuah tab peramban (Chrome DevTools Protocol) | host | loopback |
cdp-screencast | video dari sebuah tab peramban | host | loopback |
pty-shell | sebuah shell di komputer ini | host | loopback |
python-kernel | kernel Python (notebook) | host | loopback |
display-capture | tangkapan layar | halaman | none |
uvc-camera | kamera USB | halaman | none |
microphone | mikrofon | halaman | none |
Dunia simulasi menggunakan dua simulator sebagai gantinya: gcode-sim untuk saluran G-code dan servo-sim untuk bus servo.
Berikutnya
Berikan agen wewenang atas sebuah mesin: Agen dan izin tetap.