Skip to content

Command Line

Detent installs three programs.

ProgramRole
detentRead a knob from the shell, auto-starting the user agent when needed
detent-agentThe host-local agent daemon
detent-authorityThe durable authority daemon

  1. Precedence. Command-line flags override environment variables, which override configuration-file values, which override built-in defaults.
  2. Configuration files. agent.json and detent-authority.json live in the platform’s Detent config directory; --config PATH selects one explicitly. Relative paths inside a config file are resolved against the file’s directory. See Configuration.
  3. Foreground by default. Both daemons run in the foreground, which is what service managers want. --daemonize backgrounds a user instance and reports readiness or the startup error to the caller.
  4. --status is read-only. It reports what’s running and never starts anything.
  5. --system selects system-wide configuration and runtime locations, and stops detent get from ever starting a private agent.
  6. Stopping. Send SIGTERM to an unmanaged daemon; supervised services are stopped and restarted through the service manager.

Both daemons accept the same logging flags:

FlagEffect
--log-level LEVELemergency, alert, critical, error, warning, notice, info (default) or debug
-v, -vvRaise verbosity one or two steps
--verbosity 0..2Same as repeating -v
--color auto|always|neverTerminal colors; auto honors NO_COLOR and redirection
--no-colorSame as --color never

See Logging.