Skip to Content
DocsInstall CmdopOverview

Install Cmdop

Installing Cmdop means installing one binary on the machine that will do the work — curl -fsSL https://install.cmdop.com | sh on macOS and Linux, or the .exe on Windows. That single binary is the agent, the browser web console, and the terminal chat at once. There is no second package, no desktop installer, and no separate relay service to provision.

Cmdop installs as one binary on the machine that will do the work. The same binary serves the browser web console, runs the background agent, and provides the terminal chat — there is no second package to install.

Basic path

Install the binary (macOS and Linux; see Install the CLI for Windows and for a no-sudo prefix):

curl -fsSL https://install.cmdop.com | sh

Then verify it, join the machine to a fleet, and confirm it is connected:

cmdop version cmdop doctor cmdop join <join-key> cmdop status

cmdop doctor is the post-install health check; before joining it correctly reports that this machine has not yet joined a fleet.

Open the machine workspace

On a desktop host, running cmdop with no arguments opens the browser web console. On a headless host or over SSH, the same bare command opens the terminal chat instead. cmdop open always targets the browser console and starts the local relay if it is not already running, so a separate cmdop server step is not required.

On a brand-new machine the first launch runs a short guided setup that asks whether this machine should join an existing relay or create one here. Re-run it at any time with cmdop onboard; the commands above are the equivalent scriptable path.

Common questions

How do I install Cmdop?

Install the single cmdop binary on the machine that will do the work, verify it with cmdop version and cmdop doctor, then join the machine with cmdop join <join-key>.

Is there a separate desktop installer?

No. The cmdop binary is the CLI, background agent, browser web console, and desktop tray surface where supported. There is no second desktop package to install.

Do I need to run a relay before opening Cmdop?

No for the local workspace path. cmdop open starts the local relay if needed. Run cmdop server create only when you want this host to operate a relay that other machines join.

Last updated on