Navigation

CLI Commands

Core Commands

Command Description
camel setup First-time setup wizard
camel serve Start the gateway server
camel chat Terminal UI
camel "message" One-shot mode (prints response and exits)

Agent Management

Command Description
camel agents Interactive agent manager
camel agents rm <id> Remove an agent
camel soul <id> Edit agent’s SOUL.md in your editor

Sessions

Command Description
camel sessions List saved sessions
camel sessions rm <id> Delete a session
camel chat --session <id> Resume a session

Configuration

Command Description
camel config list Show all settings
camel config get <key> Get a value
camel config set <key> <value> Set a value

Cron Jobs

Command Description
camel cron List all scheduled jobs
camel cron add --schedule "1h" --prompt "Check disk usage" Add a job
camel cron rm <id> Remove a job
camel cron run <id> Run a job immediately

Maintenance

Command Description
camel doctor Run health checks
camel update Update to latest version
camel status Show server status
camel logs Tail request log
camel pairing Manage Telegram pairing requests
camel reset Delete all data and start fresh
camel uninstall Remove CamelAGI completely

Remote Access

Command Description
camel connect <url> Connect TUI to a remote gateway
camel watch [url] Monitor a running gateway in real-time
camel tailscale Interactive Tailscale setup wizard
camel tailscale link [host] Connect to remote CamelAGI via Tailscale
camel tailscale status Check Tailscale status and config
camel tailscale serve Enable Tailscale Serve (private tailnet)
camel tailscale funnel Enable Tailscale Funnel (public HTTPS)

Connect to a remote server

camel connect ws://192.168.1.10:18305 --token <token>
camel connect wss://my-mac.tailnet.ts.net

Watch a running gateway

camel watch                         # Watch local gateway
camel watch wss://my-mac.ts.net     # Watch remote gateway

Shows live events: messages in/out, tool calls, thinking, subagents, retries, errors.

Tailscale link

camel tailscale link                          # List tailnet devices, pick one
camel tailscale link my-mac-mini.tailnet.ts.net  # Connect directly

Opens a full TUI connected to the remote — commands run on the remote machine.

Remote one-shot

CAMELAGI_REMOTE_URL=http://server:18305 CAMELAGI_TOKEN=xxx camel "check disk usage"

Server Options

camel serve                    # Default (port from config)
camel serve --port 3000        # Custom port
camel serve --host 0.0.0.0     # Bind to all interfaces
camel serve --generate-token   # Generate auth token and save to config

Daemon (macOS)

camel daemon install     # Install as launchd service
camel daemon uninstall   # Remove service
camel daemon status      # Check if running