Install the CLI

The cmdop CLI is a single Go binary. It carries the same agent core as the desktop client and is the right pick when you live in a terminal, run on a server, or need to script CMDOP into CI.

The desktop installer already includes cmdop on PATH. Install the CLI standalone only if you do not want the GUI, or if this machine is headless.

One-liner

macOS / Linux


curl -sSL https://cmdop.com/install.sh | bash

The script picks the right binary for your platform, drops it under /usr/local/bin/cmdop (or ~/.local/bin/cmdop if /usr/local/bin is not writable), and confirms with cmdop --version.

Windows


iwr -useb https://cmdop.com/install.ps1 | iex

Installs to %LOCALAPPDATA%\cmdop\bin\cmdop.exe and adds it to the user PATH.

Homebrew (macOS / Linux)


brew install cmdop/tap/cmdop

Tracks the latest stable release. Update with brew upgrade cmdop.

Manual binary

Grab a release artifact from cmdop.com/downloads :

OS	Arch	File
macOS	universal	`cmdop-darwin-universal.tar.gz`
Linux	x86_64	`cmdop-linux-amd64.tar.gz`
Linux	arm64	`cmdop-linux-arm64.tar.gz`
Windows	x86_64	`cmdop-windows-amd64.zip`

Extract, move cmdop somewhere on PATH, then cmdop --version.

First run


cmdop login
cmdop agent start
cmdop agent status

The verdict should be ONLINE within a few seconds. From here:


cmdop chat "What's my macOS version?"

See Quickstart for the rest of the path.

Shell completion


# bash
cmdop completion bash > /etc/bash_completion.d/cmdop
 
# zsh
cmdop completion zsh > "${fpath[1]}/_cmdop"
 
# fish
cmdop completion fish > ~/.config/fish/completions/cmdop.fish

Updating


cmdop update             # check, prompt to apply
cmdop update check       # check only, exit
cmdop update apply       # apply a staged binary

The daemon runs a daily check in the background; you usually only need cmdop update apply to swap in the new binary.

Uninstall


# macOS / Linux
sudo rm /usr/local/bin/cmdop  # or wherever it lives
rm -rf ~/.cmdop
# Linux logs
rm -rf ~/.cache/cmdop
# macOS logs
rm -rf ~/Library/Logs/cmdop
 
# Homebrew
brew uninstall cmdop


# Windows
Remove-Item -Recurse "$env:LOCALAPPDATA\cmdop"
Remove-Item -Recurse "$env:USERPROFILE\.cmdop"

Where the CLI puts state

Same per-user ~/.cmdop/ layout the desktop uses — see install overview.

Troubleshooting

cmdop: command not found. The install script wrote to a directory not on your PATH. Add ~/.local/bin (Linux/macOS fallback path) to your shell’s PATH.
Daemon never reaches ONLINE. Run cmdop agent logs -f. Most failures are auth-related — cmdop login again.
cmdop update apply fails with “binary in use”. Quit any desktop client first.