Skip to Content
DocsConnectCLI machine chat

CLI machine chat

The terminal is a first-class door into the same conversation the browser shows. It is the default door on a headless host, where bare cmdop opens chat rather than a browser.

This machine

cmdop chat

An interactive chat opens in your terminal. Type a request in plain language and press Enter; /exit or Ctrl+C leaves it.

For a single answer without the interactive interface — the form to use in scripts and CI:

cmdop chat -p "show me the 5 largest files in this directory"

The agent runs, prints its answer, and returns you to the shell.

Useful flags on both forms: -m/--machine to target a machine, --repo or --cwd for project scope, --model to pick a model, and -c/--continue or --resume to pick up a previous conversation. Run cmdop chat --help for the full set on your installed version.

Another machine’s agent

cmdop fleet <machine> cmdop fleet # interactive picker when you omit the name

cmdop fleet chats with another machine’s agent: the request is answered on that machine, in its own context. It is a conversation, not a terminal — for a shell, use interactive attach.

Which command do I want?

GoalCommand
Chat with this machinecmdop chat
One answer, no interactive interfacecmdop chat -p "..."
Chat with another machine’s agentcmdop fleet <machine>
A shell on another machinecmdop connect <machine>
One command on this host’s targetcmdop connect exec <machine> -- <cmd>

Common questions

How do I chat with a Cmdop machine from the terminal?

Use cmdop chat for an interactive terminal conversation with this machine’s agent, or cmdop chat -p "..." when a script needs one answer without the interactive interface.

How do I chat with another machine’s agent?

Use cmdop fleet <machine>. The request is answered on the target machine, in that machine’s own context. It is agent work, not a shell.

When should I use cmdop connect instead?

Use cmdop connect <machine> when a person needs an interactive terminal on another machine. Use cmdop fleet when the target machine’s agent should do bounded work and reply.

Last updated on