Skip to Content
CLIRemote machinescmdop machines

cmdop machines

cmdop machines is a read-only inventory. It lists every machine in every fleet you are a member of, in one request.

cmdop machines cmdop machines --online cmdop machines --json
FlagPurpose
--onlineHide offline machines.
--jsonEmit JSON instead of a table.

How it differs from cmdop connect --list

Both print machines, but they answer different questions:

CommandScopePurpose
cmdop machinesEvery fleet you belong toInventory. Viewer only — it does not attach.
cmdop connect --listOne fleet, tied to the attach flowPick a target to connect to.

Use cmdop machines to answer “what do I have and what is up right now”, then cmdop connect <machine> to actually attach a terminal to one of them.

Automation output

Use --json when another tool or script needs the inventory. Treat the result as a snapshot: online state can change between listing a machine and trying to connect to it. A failed attach after a successful inventory usually means the target went offline, the selected relay changed, or the target no longer allows the requested access.

Last updated on