Machine identity
A machine in Cmdop is a real computer that has joined a relay and runs the Cmdop agent. It holds the files, the installed tools, the project folders, and the execution authority for work done in its sessions. Machines are the unit you select, the unit you reach, and the unit plans count. A machine is online only while its agent is connected.
A machine is a joined computer running the Cmdop agent. It is where work actually happens: it holds the files, the installed tools, the project folders, and the execution authority for everything done in its sessions.
Machines are the unit you select, the unit you reach, and the unit plans are counted in.
How a machine is identified
Each machine carries a human-readable display name — the name you see in the roster and type at the CLI:
cmdop connect --list
cmdop connect <machine-name>The configured display name is authoritative; the operating-system hostname is
only a fallback while resolving it. One name in the roster is reserved: server
addresses the relay’s fleet orchestrator rather than a physical computer.
Online is a live property
A machine is online only while its agent holds its connection to the relay. It
is not a stored attribute you can rely on between sessions: drop the connection
and the machine leaves the reachable set until it returns. cmdop connect --list --online shows only the ones currently reachable.
What a machine selection is not
Selecting a machine in the browser picks a target, not a path and not a credential.
- The browser never becomes the authority for that machine’s filesystem paths. A chosen project folder becomes an opaque Project Root that the machine itself resolves — the raw path does not become browser-owned state.
- Being able to see a machine in the roster is not the same as being able to open a terminal on it. Remote terminal attach has its own reachability and authentication requirements — see Connect.
Common questions
What is a machine in Cmdop?
A machine is a joined computer running the Cmdop agent. It owns the files, installed tools, project folders, sessions, and execution authority for the work that happens there.
Does online mean the machine has an open port?
No. Online means the machine’s agent has a live outbound connection to its relay. It does not imply that the machine has an inbound port open or that interactive terminal attach is available.
Why can I see a machine but not attach to it?
Roster visibility and terminal attach are different. A machine can be known or online while remote terminal attach still requires the target’s own reachable relay door and authentication.
Cmdop