Skip to content

Menu and hotkey

DasDuo edited this page Jun 29, 2026 · 2 revisions

The menu & the global hotkey

ShuttleX lives in the menu bar. You open its dropdown two ways and connect from there.

Opening it

  • Click the menu-bar icon — the dropdown opens anchored under the icon (the classic SSHMenu/Shuttle feel).
  • Global hotkey — press your configured shortcut from anywhere to open ShuttleX as a centered, Spotlight-style window; press it again to close. It's off by default — set it in Settings → General → "Global hotkey". Clicking the icon and the hotkey open the same panel, just positioned differently.
  • Right-click the menu-bar icon for a small menu: Open, Settings…, Quit.

The top bar

Across the top of the dropdown:

  • The ShuttleX title (with a BETA badge on prerelease builds).
  • A source badge showing the active server source — ~/.ssh/config, JSON file, or Remote URL.
  • Reload (↻) — re-read the current source.
  • The Settings gear — opens Settings (same as ⌘,).

Finding and connecting

  • The search field is focused the moment it opens — just start typing.
  • Search matches the server name, the host/target, and the group name — and tags, if enabled. A query like web keeps the whole Prod · web group.
  • Keyboard: ↑ / ↓ move the selection (the list scrolls to follow), Enter connects the selected server, Esc closes. The search clears after you connect.
  • Or just click a row. The dropdown closes and the connection opens in your chosen terminal.

Groups and favorites

  • Groups are collapsible — collapsed by default, click the header to expand. While searching, matching groups expand automatically.
  • ★ Favorites sit in a section at the very top. Hover a row and click the star to pin (or use the toggle in the editor). The section is expanded by default when small and always collapsible. The JSON source writes favorite into the file; the remote source keeps favorites locally, per person.

Per-row actions

  • Right-click a server → "Copy SSH command" copies the built ssh … line to the clipboard — for sharing in chat, pasting into another terminal, or a ticket. Works for every source.

The footer

Along the bottom of the dropdown:

  • Terminal picker — switch the terminal app on the fly (only installed apps are listed).
  • Open in picker — new window / tab / split, where the terminal supports it (see Terminals & launch modes).
  • Quit — the power button on the right closes ShuttleX.

(Reload and Settings live in the top bar, not the footer.)

Clone this wiki locally