Agent Management

The Cmdop agent runs in the background, maintaining connectivity.

Start Agent


cmdop agent start

Run in foreground for debugging:


cmdop agent start --foreground

Stop Agent


cmdop agent stop

Restart Agent


cmdop agent restart

Check Status


cmdop agent status

Output:


Agent Status: Running
PID: 12345
Machine ID: abc123xyz
Connected: Yes
Last Ping: 2s ago
Uptime: 4h 23m

View Logs


cmdop agent logs

Follow logs in real-time:


cmdop agent logs -f

Log Locations

Platform	Location
macOS	`~/Library/Logs/cmdop/agent.log`
Linux	`~/.cmdop/logs/agent.log`
Windows	`%APPDATA%\cmdop\logs\agent.log`

Auto-Start

macOS (launchd)


cmdop agent install

Linux (systemd)


cmdop agent install --systemd

Windows (Service)


cmdop agent install --service

Uninstall Auto-Start


cmdop agent uninstall

Agent Configuration

Config file: ~/.cmdop/config.yaml


agent:
  log_level: info
  reconnect_interval: 5s
  ping_interval: 30s
 
connection:
  relay_url: wss://relay.cmdop.com
  api_url: https://api.cmdop.com

Resource Usage

The agent is designed to be lightweight:

Memory: ~20-50 MB
CPU: Less than 1% idle
Network: Minimal (WebSocket keepalive)

Troubleshooting

Agent Won’t Start

Check if already running: cmdop agent status
Check logs: cmdop agent logs
Verify credentials: cmdop login

Connection Issues

Check network: curl https://api.cmdop.com/health
Check firewall settings
Try restart: cmdop agent restart