Adom Desktop — verb reference

Every verb and subcommand adom-desktop supports, by category. Each is invoked as adom-desktop <verb> '<json args>' from the cloud container (or the local CLI) — and the same names are the dispatch keys the cloud AI uses over the relay. Bridge verbs (kicad_*, fusion_*, browser_*, hd_*) auto-spawn their bridge on first call.

How to read an entry: each verb lists its Args (required/optional), what it Returns, any Note / Workflow / Prerequisite, and an Example. Every failing response also carries a _hint string telling you the next step — surface it to the user verbatim. This page is generated from the live help-map; run adom-desktop commands for the machine-readable source.

  • Connectivity (5 verbs) — Liveness, status, multi-AD targeting.
  • Setup (1 verb) — One-time desktop setup.
  • Shell & process (6 verbs) — Run shell commands, scripts, WSL, and launch/locate apps on the laptop.
  • File transfer (2 verbs) — Move files between the cloud container and the laptop (streamed, SHA-verified).
  • Desktop & bridge mgmt (44 verbs) — Windows, screenshots, files, embedded mode, relay servers, tunnels, and bridge lifecycle.
  • Screen recording (7 verbs) — Record the desktop/monitors to video; manage the recorder window.
  • Notifications (1 verb) — Native desktop toast notifications.
  • Project watch (1 verb) — Watch a local folder + sync changes.
  • Browser (Puppeteer) (31 verbs) — Drive Chrome-for-Testing: navigate, eval, screenshot, record, tabs/windows, credentials.
  • KiCad bridge (27 verbs) — Drive KiCad 7/8/9/10: open designs, DRC/ERC, libraries, 3D, screenshots, lint.
  • Fusion 360 bridge (63 verbs) — Drive Fusion 360: CAD export, cloud docs, EAGLE electronics, manufacturing, UI.
  • Hydrogen Desktop (22 verbs) — Build, ship, screenshot, and drive the embedded Hydrogen Desktop.

Total: 210 verbs/subcommands across 12 categories.

Generated from the CLI help-map (adom-desktop commands) — the source of truth. Run adom-desktop status from the cloud container for the same map plus live connection state.