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?
Last updated on
Cmdop