CLI reference

The local service stays in the background once installed; these commands are for attaching projects, checking status, and other maintenance.

Commands

curxor status
Show the install state, running state, and health-check results, and print the log path.
curxor attach [origin]
Associate the current project root with a dev server origin; without an origin it scans common ports.
curxor mcp --print-config
Print the editor MCP config snippet (read-only, writes no files).
curxor update
Update to the latest release and restart the local service. --check only checks, --version x.y.z pins a version.
curxor start
Register (first run) and start the local service; auto-starts at login, and restarts on crash on macOS / Linux.
curxor stop
Stop curxor. It stays stopped until you run curxor start.
curxor uninstall
Stop and remove the local service (keeps the binary and ~/.curxor data).

Running curxor with no arguments is the same as curxor status. curxor --help lists every command; curxor --version prints the version.

Port and logs

  • The local service always listens on 127.0.0.1:51999 and never migrates ports; if the port is taken the service fails to start — free it first.
  • The log path is printed by curxor status (on macOS: ~/Library/Logs/curxor/agent.err.log).

For AI agents: llms.txt · llms-full.txt