Skip to main content

Global flags & entry points

A few entry points are handled directly by rt's CLI entry (cli.ts), before any command-tree dispatch (except --help, which the dispatcher itself handles at every depth). These are not tree commands, so they don't have their own generated reference page.

--version / -V​

rt --version
rt -V

Prints the installed version (rt <version>) and exits.

--help / -h​

rt --help
rt daemon --help

Unlike the other flags on this page, --help is handled by the command-tree dispatcher itself, so it works on every command and subcommand, not just at the root. See Common flags for the full behavior.

--grant-fda​

rt --grant-fda

Opens System Settings to the Privacy & Security → Full Disk Access pane and prints instructions for adding mattstack.app. The daemon inherits this grant from the app bundle, so the grant target is mattstack.app, not rt itself. Restart the daemon (rt daemon restart) after granting. Note that re-signing the bundle — which any rebuild does — invalidates the grant and it must be given again.

Internal entry points​

Two other top-level flags exist but are not meant to be run by hand:

  • --daemon starts the daemon server process directly. It's the entry point the daemon's launcher (launchd, or a background process) runs internally (rt --daemon) when rt is a compiled binary; you shouldn't need to run it yourself.
  • --post-install is the developer/installer entry point invoked by the Homebrew formula's post_install hook. It sets up the tray app, editor extension, daemon, and shell integration. rt also runs this transparently on first use if setup hasn't completed yet.