CMDOP CLI — one binary
The terminal that talks back.
AI chat, remote machines, file transfers, browser automation, and OS control — all from a single cmdop binary.
macOS · Linux · Windows · Homebrew
How it works
Three steps to full control
Install & authenticate
One curl command, then `cmdop login`. Works on macOS, Linux, Windows.
$curl -sSL cmdop.com/install.sh | bash
$cmdop login
$cmdop doctor
Chat or connect remotely
Bare `cmdop` opens AI chat. `cmdop connect` registers this machine for remote access.
$cmdop
$cmdop connect
$cmdop ssh prod-01
Automate with skills & triggers
Install skills, schedule jobs, and use `cmdop os` for desktop automation.
$cmdop skills list
$cmdop run <skill>
$cmdop trigger list
Everything in one binary
Built for real workflows
AI Chat in terminal
Bubble Tea TUI with models, slash commands, and session resume. Plain mode for scripts.
$cmdop
$cmdop chat --model @code
$cmdop --resume <id>
Remote machines
SSH-style shell, machine graph, workspace roles — all from one binary.
$cmdop ssh prod-eu-01
$cmdop machines --output json
$cmdop workspace use acme
Files & transfers
Get, put, and sync files across any connected machine without SCP setup.
$cmdop files get prod:/var/log ./logs
$cmdop files put ./patch.sh prod:~/
$cmdop files ls prod:/var
Browser & OS automation
Headless browser with stealth + full desktop control from the same terminal session.
$cmdop browser open https://...
$cmdop os screenshot
$cmdop os type "Hello"
Skills & triggers
Install ready-made skills, run them on demand or on a schedule.
$cmdop skills list
$cmdop run email-macos
$cmdop trigger list
Auth & access control
OAuth login, session tokens, workspace policies — no open ports needed.
$cmdop login
$cmdop agent status
$cmdop doctor
Reference
Command reference
Tables synced with the open-source cmdop binary. For full prose, see binary commands doc.
Quick Start
Typical flow after installing the binary (see also cmdop doctor).
Commands
Top-level commands follow Cobra help groups: "Commands:" (daily use) and "Advanced:" (config, service, MCP, …). Source: cmdop_go/go/cmd/cmdop.
Main
Default (no subcommand) & AI chat
| cmdop | Interactive AI chat (TTY: Bubble Tea UI; same as cmdop chat) |
| cmdop chat | Interactive AI chat; --plain, --model, --tools, etc. |
Authentication & connection
| cmdop login | OAuth device flow; optional --dev, --tray, --no-agent |
| cmdop logout | Clear stored credentials |
| cmdop connect | Connect this machine to Cmdop (registers host, prints web terminal URL) |
Background agent
| cmdop agent start | Start agent (--foreground for debug, --with-mcp, …) |
| cmdop agent stop | Stop agent |
| cmdop agent status | Show agent status |
| cmdop agent restart | Restart agent |
| cmdop agent logs | Tail agent logs (-n, -f, --raw) |
Updates, observability, diagnostics
| cmdop update | Check / install updates (see update check, apply, schedule) |
| cmdop monitor | TUI: logs, metrics, gRPC |
| cmdop logs | Daemon logs (-f, -n, --open, --path) |
| cmdop doctor | Diagnose PATH, login, agent; optional --install-cli |
| cmdop setup | Copy binary to user PATH (~/.local/bin); same idea as doctor --install-cli |
| cmdop version | Print version, commit, build date |
Skills, models, local tools
| cmdop skills … | list | show | install | create | check | … |
| cmdop run <skill> … | Run a skill from the registry |
| cmdop models | Show default LLM model (when logged in) |
| cmdop highlight <file> | Syntax-highlight files (alias-friendly) |
Automation & media
| cmdop os … | OS automation: list, focus, type, key, click, screenshot, … |
| cmdop trigger … | Scheduled agent triggers (list, add, remove, …) |
| cmdop password … | set | clear | status — protect SDK attach |
| cmdop ffmpeg … | install | status | probe | transcode — media helpers |
Advanced
Configuration & auth (advanced group)
| cmdop config | Open settings TUI with no subcommand; or config show | get | set |
| cmdop config set mode <dev|prod> | Switch server mode (replaces hidden set-mode) |
| cmdop auth status | Detailed auth status (use top-level login/logout for daily use) |
Service, sessions, integrations
| cmdop service … | install | uninstall | start | stop | restart | status (--system for elevated) |
| cmdop session … | create | list | attach | detach | destroy | save | restore |
| cmdop mcp … | stdio | tools — MCP server for IDEs |
| cmdop completion … | Shell completion scripts |
| cmdop debug … | Developer diagnostics |
| cmdop serve … | Local serve (advanced) |
| cmdop extract … | Extract helpers (advanced) |
Monitor TUI
Run `cmdop monitor` for logs, metrics, and gRPC activity.
| Tab | Switch tabs (logs / metrics / gRPC) |
| ↑/↓ or j/k | Scroll |
| a | Toggle auto-scroll |
| c | Clear current tab |
| q | Quit |
Config & Logs
Config location
macOS/Linux: ~/.config/cmdop/config.yaml
Windows: %APPDATA%\cmdop\config.yaml
Log location
See: cmdop logs --path (resolves per platform)
macOS: ~/Library/Logs/cmdop/ (typical)
Linux: ~/.cmdop/logs/ (typical)
Global flags
Persistent flags on the root command (see cmdop --help).
| --debug | Enable debug mode (verbose logs) |
| --log-level | Log level: debug, info, warn, error |
| --log-format | Log format: json, console |
| --resume=<session-id> | Resume TUI chat session (also on root: cmdop --resume=…) |