CLI

The primary daemon management interface is comma daemon. The legacy comma-agents-daemon binary remains available for direct daemon process control.

comma daemon start
comma daemon status
comma daemon stop
comma daemon restart

Use comma daemon enable or comma daemon disable to manage user-level daemon autostart.

The compatibility binary supports start, stop, restart, and status.

start

Starts the daemon. By default, it detaches and runs in the background. Pass --foreground to run in the current terminal.

# Background mode (default)
comma-agents-daemon start

# Foreground mode
comma-agents-daemon start --foreground

Flags

# Start on a custom port
comma-agents-daemon start --port 9090

# Start in foreground with model override and verbose logging
comma-agents-daemon start --foreground --model-override github-copilot/gpt-4o --verbose

If the daemon is already running, start exits with an error message and exit code 1.

restart

Stops the daemon, then starts it again with the same flags as start.

comma daemon restart
comma-agents-daemon restart --verbose

stop

Stops a running daemon by sending SIGTERM to the process recorded in the PID file. It polls for up to 5 seconds for the process to exit.

# Stop the daemon
comma-agents-daemon stop

If no PID file is found (or it's stale), the command exits cleanly with status code 0.

status

Reports whether the daemon is running, and if so, prints configuration details.

# Check daemon status
comma-agents-daemon status
comma daemon status --json

Sample output (running)

Daemon is running (PID: 12345)
  Config: /home/user/.comma/daemon.json
  PID file: /home/user/.comma/daemon.pid
  Port: 7422
  Host: 127.0.0.1

Sample output (not running)

Daemon is not running

autostart

Autostart is managed through comma daemon enable and comma daemon disable.