Skip to main content

The tray app

The rt-tray menu bar app shows daemon health at a glance and delivers native notifications, so you don't need a terminal open to know something happened.

The dot

DotMeaning
Greendaemon running normally
Yellowdaemon starting
Orangepending notifications
Reddaemon not reachable

From the tray menu you can:

  • restart the daemon
  • stop the daemon
  • toggle launch-at-login
  • check for updates

Pane focus

When rt pane focus targets a pane, the tray activates the terminal window hosting it. This works for both regular panes and daemon-hosted background panes.

Window behavior

The app stays a regular Dock app for its entire run, so the Dock icon keeps its running indicator. Cmd-W closes the window (and cmd-M minimizes it). Quitting the app when no window is on screen is a real quit, whether from the Dock, Activity Monitor, or a script.

The app catalog is fetched at launch rather than on first window open. This means the first handoff or browser click opens the window without a catalog-fetch delay. Startup shows a fixed-life splash with a loading indicator while the window settles.

Cmd-F opens find in page inside the mattstack window.

Settings opens as a native tabbed window (General, Permissions, Fast Browser, Team, Uninstall); the titlebar names the active pane. The General tab's Dev mode switch swaps between the installed app and the dev flavor after a confirmation, quitting the current app and launching the other.

Updates

The tray app never self-upgrades. When a newer release is available, it notifies you and prompts you to run rt update yourself; it does not download or install anything on your behalf.

See also: the daemon guide for what the daemon itself does, and rt daemon / rt update in the command reference.