Agents & Machines
runOnMachine
Run on Machine
Run a single shell command on one of your machines (a MachineSync box) through The Cloud, and stream its output back into the Agents view: box ops without a physical terminal (update the daemon,…
Arguments
commandstringrequiredThe shell command to run on the box, e.g. `thecloud service status` or `pkill -f local/bin/thecloud`. A single command line; it runs as the daemon's own user.cwdstringoptionalWorking directory to run the command in. Defaults to the daemon's working directory.machineIdstringoptionalWhich machine to run on (machineId from listMachines). Omit only when exactly one machine is active.timeoutMsnumberoptionalHard timeout in milliseconds: the command is killed if it runs longer. Defaults to the box-side bound.
Returns
The registry does not declare a return shape.
Ask for it
The Cloud routes these requests to this verb.
- run X on my machine
- update the daemon on box N
- restart the box
- tail the log on…
Pair it with
The verbs that finish the job.