Documentation

Terminal CLI

Read the same live metrics from a shell, as text or as JSON.

The direct download embeds a command-line client that reads the same live snapshots the dropdowns show. Handy for scripts, status bars in other tools, or just checking a number without reaching for the mouse.

/Applications/Operator.app/Contents/MacOS/operator-cli status /Applications/Operator.app/Contents/MacOS/operator-cli cpu --json /Applications/Operator.app/Contents/MacOS/operator-cli install # put `operator` on your PATH

Operator.app must be running. The CLI reads from the app, never from the privileged helper — that channel stays private to Operator itself.

Commands

  • status — a one-line summary of the machine
  • snapshot — every domain at once
  • cpu, gpu, memory, network, disk, battery, sensors, ai — one domain
  • processes — the ranked process list, sortable and limitable
  • watch — follow one domain live at an interval you choose
  • install / uninstall — manage the operator symlink on your PATH

Every command takes --json, which is the form to use when something else is going to parse the output.