Full Command Reference

Every cmdop verb in one table, grouped by theme. Source pointers reference the Go CLI tree under cmd/cmdop/cmds/.

Global flags

Flag	Values	Description
`--debug`	—	Verbose logging
`--log-level`	`debug` / `info` / `warn` / `error`	Log verbosity (env `CMDOP_LOG_LEVEL`)
`--log-format`	`json` / `console`	Log format
`--resume`	session-id	Resume a previous TUI chat session
`--mode`	`dev` / `prod`	Token + endpoint scope
`--workspace`	name	Override active workspace for one invocation
`--api-key`	token	Inline API key (also `CMDOP_API_KEY` env)
`--server`	URL	Override control-plane address
`--json`	—	Script-friendly output
`--no-interactive`	—	Fail instead of prompting
`--help`, `-h`	—	Show help
`--version`, `-v`	—	Show version

Command	Description
`cmdop`	Bare = `cmdop chat`
`cmdop chat`	Interactive AI chat (TTY → TUI; pipe → line-based)
`cmdop chat --machine vps-audi`	Chat targeted at a specific machine
`cmdop chat --issue CMD-42`	Anchor chat output to a Board issue
`cmdop chat --debug-prompt`	Print rendered system prompt to stderr
`cmdop run <skill> [prompt...]`	One-shot skill execution
`cmdop skills list` / `show` / `dir` / `create` / `check` / `install` / `uninstall`	Skill CRUD
`cmdop instructions list` / `show` / `set` / `clear` / `default`	System prompt presets
`cmdop models`	List models
`cmdop style list` / `show` / `set`	Personality presets
`cmdop highlight <file>`	Syntax-highlighted file display (also `ccat`)

Command	Description
`cmdop connect [host]`	Interactive picker / direct attach
`cmdop connect exec <host> -- <cmd>`	One-shot remote exec
`cmdop connect key set` / `get` / `clear`	Workspace API key CRUD
`cmdop connect password set` / `clear` / `list` / `status`	Per-machine bcrypt password
`cmdop connect workspace list` / `use` / `remove` / `sync`	Workspace switcher
`cmdop connect share <host>`	Mint a share-link
`cmdop terminal <host>`	PTY (alias for `cmdop connect`)
`cmdop exec <host> "<cmd>"`	One-shot (alias for `cmdop connect exec`)
`cmdop files ls` / `get` / `put` / `cat` / `rm` / `mkdir` / `cp` / `mv` / `info` / `sync`	Remote file operations

Command	Description
`cmdop agent start`	Start daemon. Flags: `--foreground`, `--with-mcp`, `--no-power-blocker`
`cmdop agent stop`	Stop daemon, mark machine offline immediately
`cmdop agent status`	ONLINE / DEGRADED / STARTING
`cmdop agent restart`	Reload binary or config
`cmdop agent restart-delayed`	Internal: deferred restart for updates
`cmdop agent logs`	View daemon logs
`cmdop start` / `stop` / `restart` / `status`	Top-level shortcuts
`cmdop logs`	Top-level logs alias. Flags: `-n`, `-f`, `--raw`
`cmdop mode dev` / `prod` / `toggle`	Switch mode
`cmdop monitor`	Live daemon TUI
`cmdop update` / `check` / `apply` / `schedule`	Self-update
`cmdop service install` / `uninstall` / `start` / `stop` / `restart` / `status`	OS service registration

Command	Description
`cmdop login`	OAuth sign-in
`cmdop logout`	Clear credentials
`cmdop auth status`	Identity + workspace + expiry
`cmdop auth password set` / `clear` / `status` / `mfa` / `export`	OAuth password / MFA
`cmdop register`	Foreground first-time machine registration
`cmdop machines`	List machines in workspace

Command	Description
`cmdop permissions list` / `allow` / `ask` / `deny` / `revoke` / `mode` / `audit`	Permission rule CRUD
`cmdop issue list` / `show` / `create` / `update` / `close` / `delete`	Board CLI
`cmdop session create` / `list` / `attach` / `detach` / `destroy` / `save` / `restore`	Terminal session management
`cmdop trigger list` / `add` / `remove` / `enable` / `disable` / `health` / `history`	Scheduled tasks
`cmdop os list` / `active` / `focus` / `type` / `key` / `click` / `move` / `scroll` / `screenshot` / `clipboard` / `launch` / `quit` / `apps` / `script` / `ui`	OS automation

Command	Description
`cmdop doctor`	Health check (PATH, login, daemon, perms)
`cmdop env [filter]`	Env vars + SDKRouter config
`cmdop mcp stdio` / `tools`	MCP integration (Claude Desktop, Cursor)
`cmdop serve`	Local API server (REST surface)
`cmdop setup`	First-time setup wizard
`cmdop tui`	Force TUI in non-TTY env
`cmdop cache stats` / `clear` / `path`	RAG / agent cache
`cmdop config` / `show` / `get` / `set`	Config CRUD
`cmdop debug`	Diagnostic dump for support
`cmdop completion bash` / `zsh` / `fish`	Shell completion
`cmdop help <topic>`	Unified help registry
`cmdop version`	Version + build info

Command	Description
`cmdop provider`	Interactive manager (default)
`cmdop provider add` / `set` / `default` / `delete` / `test` / `edit-key`	Scriptable subcommands

Command	Description
`cmdop media ffmpeg` / `extract` / `dream`	Media file operations

Code	Meaning
0	Success
1	General error
2	Invalid arguments
3	Authentication error
4	Connection error
5	Timeout
6	Permission denied (gate)
7	Update conflict (cross-user cache split)

Deploy across multiple hosts in parallel:


for host in web-1 web-2 web-3; do
  cmdop connect exec "$host" -- ./deploy.sh &
done
wait

Backup with date stamp:


cmdop connect exec prod-server -- "tar czf - /data" > backup-$(date +%Y%m%d).tar.gz

Multi-host fan-out via the agent (ask_agents):


cmdop run multi-check vps-audi vps-bmw mac-studio

Scheduled health check via trigger:


cmdop trigger add --name health-check --schedule "*/15 * * * *" \
  --skill check-services --machine prod-server