System Tray
The tray menu is always visible on macOS, Windows, and Linux. It shows connection state, lets you connect or disconnect, exposes a “stay disconnected across restart” toggle, and gives one-click access to the main window, the launcher, and settings. Disconnect closes the connection but does not sign you out.
The system tray is the always-on companion to the main window. Even with the desktop hidden, the tray icon tells you whether the agent is reachable and lets you flip connection state in one click.
Tray location per platform
The tray lives in the macOS menu bar (top right), the Windows system tray (bottom right), and the Linux app indicator. On macOS the activation policy is not Accessory — the dock icon stays visible by design, because Apple’s review process requires visible feedback for apps that perform background work.
Status indicator
The tray icon’s colour reflects connection state — green for connected, yellow for connecting or reconnecting, and red for disconnected or errored. The first line in the tray menu shows the verbose state: uptime when connected, a reconnect countdown when reconnecting, the last byte timestamp when stale, or the error message when the connection has failed.
Connect / Disconnect — what they actually do
This is the most important section on the page. Clicking Disconnect closes the live connection so no bytes leave the process, but your login stays in the keychain. Clicking Connect reopens the connection, resumes heartbeats, and the fleet sees you online again. Concretely:
- Connect — reopen the connection, resume heartbeats, machines online.
- Disconnect — close the connection, heartbeats stop, machines look offline to the fleet, but you stay logged in.
Disconnect is not Sign out. The token stays in the keychain, so reconnect is one click. To revoke the token entirely, use Settings → Account → Sign out, or cmdop logout in the CLI.
”Stay disconnected across restart”
The tray menu has a checkbox labelled “Stay disconnected across restart”. When ticked, the desktop turns off auto-connect. On the next launch the desktop comes back in disconnected state until you click Connect (or untick the box). This is the safe choice when stepping away from a shared machine without signing out.
“Stay disconnected” is sticky across restarts and affects every machine your fleet tracks until you reconnect. The same toggle is also exposed in Settings → Connection and the Connection tab.
Other tray menu items
The tray menu also exposes quick window toggles — Open Chat, Open Launcher, Open Settings — plus version info, “Check for updates”, and Quit. These mirror the same actions available from inside the main window so you do not have to bring it forward to use them.
Right-click vs. left-click on macOS
Both buttons open the same menu on macOS — there is no separate right-click action. On Windows the system tray follows OS convention (left-click toggles, right-click opens the menu).
Notifications and tray badge
Certain events raise system notifications: a permission ask while the window is hidden, an agent finishing a long-running task, an outage detected by the connection service. The tray icon may also show a small badge for unread events; the badge style and notification filters live in Settings → Appearance.
Cmdop