CLI reference / host / console

stado host console

Invocation

stado host console <COMMAND>

Purpose

Whether anybody can answer a question macOS shows at TARGET's screen: who owns /dev/console and which display panels (the built-in one, or a monitor that names itself) macOS reports online, measured on the host and recorded as `targets[].console` (`headless` or `attended`). On a Mac whose recorded console is headless, Stado's units run as launchd daemons, which macOS never asks about the local network, and `stado host upgrade` plans no dialog there.

Required inputs and options

This command has no command-specific inputs or options.

Output and state effect

This command group selects one of the subcommands listed below; use its exact child invocation to perform an operation.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.

Subcommands

  • show — Measure TARGET's console and print it beside the recorded one. Exits non-zero when they differ, or when TARGET measures headless and records no console
  • record — Measure TARGET's console and record the measurement as `targets[].console`. A headless console is refused while the target declares a privacy grant or a work root in Documents, Desktop or Downloads, each a question nobody there answers
  • unset — Remove TARGET's recorded console; Stado then treats the host as attended