Install
CMDOP ships as one Go core wrapped in different surfaces. They share state — the same daemon, the same workspace credentials, the same audit log. Pick the surface(s) that match where you actually work; you can always add more later.
Pick your install
macOS, Windows, Linux. Recommended for everyday work — seven tabs, global hotkey, per-machine inspector chat. Includes the daemon and the cmdop CLI.
Standalone cmdop binary. Same agent core as the desktop. Best for scripts, terminals, and headless laptops.
Servers and VPSes like vps-audi. cmdop register once, then cmdop agent start (or a service unit) keeps the machine online.
iOS and Android — companion client for monitoring and quick prompts on the go.
What lands on disk, regardless of surface
Every CMDOP install creates the same per-user directory the first time the binary runs:
| Path | Mode | What |
|---|---|---|
~/.cmdop/cmdop.pid | 0644 | Per-euid PID file for the daemon. |
~/.cmdop/daemon.status | 0644 | Status the desktop / cmdop agent status watches. |
~/.cmdop/cmdop.db | 0600 | Local SQLite — backlog, sessions, machine identity. |
~/.cmdop/ssh_workspaces.json | 0600 | Workspace credential store. |
~/.cmdop/permissions.yaml | 0600 | Permission rules (created on first remote call). |
~/.cmdop/skills/ | 0700 | Global skills directory. |
Logs live under the platform log directory:
| Platform | Log dir |
|---|---|
| macOS | ~/Library/Logs/cmdop/ |
| Linux | ~/.cache/cmdop/logs/ |
| Windows | %LOCALAPPDATA%\cmdop\logs\ |
Common combinations
| Setup | Recommended |
|---|---|
| Solo dev, one laptop and one VPS | Desktop on the laptop, headless agent on the VPS. |
| Team dev, MacBook + Mac Studio + VPS | Desktop on each Mac, headless agent on the VPS. |
| Pure-CLI workflow | CLI everywhere, with cmdop service install on long-lived hosts. |
| Mobile-first ops | Desktop on the laptop + mobile companion. |
Updating
The daemon checks for updates daily and stages them. Apply with:
cmdop update # check + prompt
cmdop update apply # apply the staged binaryThe desktop app surfaces the same prompt in the Settings tab.
After install
- Quickstart — first prompt in five minutes.
- First connection — pair a remote machine.
- Agent Permissions guide — tighten the gate before exposing a fleet.
Cmdop