Browse the docs

switchboard states

Lists the States and whether each is on; forces one on or off.

Details #

switchboard states prints one line per State: a dot, the name, and since when it has been on or off.

switchboard states
switchboard states --json
switchboard states on "Deep work" --minutes 60
switchboard states off "Deep work"
switchboard states clear "Deep work"

on and off force a State until its own conditions next change its answer, or for --minutes. clear takes the override away.

Parameters #

switchboard states [--json]
switchboard states on|off|clear <name> [--minutes n]

The States and whether each is on.

Force a State on or off until it changes (or for n minutes); clear lifts it.

Gotchas #

  • Exit code 69 means the engine is not running.

See also #

A State starts or ends, Triggers that watch: becomes true, States, waiting runs