Binary command reference

TL;DR

The cmdop binary is built with Cobra. With no subcommand, it starts interactive AI chat (same as cmdop chat). Help output splits Commands: (daily use) and Advanced: (config, service, MCP, completion, …). This page mirrors that structure; authoritative source is the Go sources under cmdop_go/go/cmd/cmdop.

What happens when I run `cmdop` with no arguments?

The root command runs runChat — Bubble Tea TUI in a real terminal, or line-based chat when stdin is not a TTY. Use cmdop chat --plain to force line mode. Session resume: cmdop --resume=<id> (ID printed when you leave the TUI).

What are the global flags?

Flag	Purpose
`--debug`	Verbose logs, console format
`--log-level`	`debug` \| `info` \| `warn` \| `error`
`--log-format`	`json` \| `console`
`--resume`	Resume TUI chat by session id

Main command group (Cobra: “Commands:”)

AI chat & assistants

Command	Summary
`cmdop`	Default: interactive AI chat
`cmdop chat`	Same as above; flags: `--model`, `--plain`, `--tui`, `--tools`, `--prompt`, …

Authentication & connection

Command	Summary
`cmdop login`	OAuth device flow (`--dev`, `--tray`, `--no-agent`, …)
`cmdop logout`	Clear credentials
`cmdop connect`	Register this machine and open remote access (prints web terminal URL)

Background agent

Command	Summary
`cmdop agent start`	Start daemon (`--foreground`, `--with-mcp`, …)
`cmdop agent stop`	Stop agent
`cmdop agent status`	Status (`--debug` for details)
`cmdop agent restart`	Restart
`cmdop agent logs`	Log tail (`-n`, `-f`, `--raw`)

Updates & observability

Command	Summary
`cmdop update`	Check / install updates; sub: `check`, `apply`, `schedule`
`cmdop monitor`	TUI: logs, metrics, gRPC
`cmdop logs`	Daemon logs (`-f`, `-n`, `--open`, `--path`)
`cmdop doctor`	Diagnose PATH, login, agent (`--install-cli`)
`cmdop setup`	Install binary into user PATH (`~/.local/bin`)
`cmdop version`	Version metadata

Skills, models, local utilities

Command	Summary
`cmdop skills …`	list, show, install, create, check, …
`cmdop run …`	Run a skill
`cmdop models`	Default LLM (when authenticated)
`cmdop highlight …`	Syntax-highlight files

OS automation, triggers, secrets, media

Command	Summary
`cmdop os …`	Desktop automation (windows, keyboard, mouse, screenshots, …)
`cmdop trigger …`	Scheduled agent runs
`cmdop password …`	Protect SDK attach: `set`, `clear`, `status`
`cmdop ffmpeg …`	FFmpeg install / probe / transcode helpers

Other top-level commands in the main group include tui (interactive dashboard; may be build-tagged) and models — see cmdop --help on your build.

Advanced command group (Cobra: “Advanced:”)

Configuration

Command	Summary
`cmdop config`	No args: settings TUI; else `show`, `get`, `set <key> <value>`
`cmdop config set mode <dev\|prod>`	Server mode (deprecated hidden: `config set-mode`)

Auth namespace

Command	Summary
`cmdop auth status`	Extended status (daily use: prefer `login` / `logout`)

Service & sessions

Command	Summary
`cmdop service …`	install, uninstall, start, stop, restart, status (`--system`)
`cmdop session …`	create, list, attach, detach, destroy, save, restore

Integrations & tooling

Command	Summary
`cmdop mcp …`	`stdio`, `tools` — MCP for Claude Desktop / Cursor
`cmdop completion …`	Shell completion
`cmdop debug …`	Developer diagnostics
`cmdop serve …`	Advanced local server
`cmdop extract …`	Advanced extract helpers

What should I read next?

Install and quick start

Chat flags and slash commands

Remote connection flow