Settings

Settings

Open Settings from the gear in the dropdown, the ⌘, shortcut, or by right-clicking the menu-bar icon → Settings…. (All three open the same window.)

Terminal

• Terminal app — which terminal opens connections: Terminal, iTerm2, Ghostty, Warp, Alacritty, kitty, WezTerm. Only apps that are actually installed are offered.
• Open in — new window, tab, or split, depending on what the app supports. Details and per-terminal caveats: Terminals & launch modes.

Server source

Where hosts come from — full story in Server sources.

• ~/.ssh/config — read-only, including Include directives.
• JSON file — editable in-app; the path is configurable (Choose… / Reset to default). Add / edit servers… opens the editor; Edit file / Show in Finder / Reload act on the file itself.
• Remote URL — a read-only team inventory loaded from an https:// URL (details). Edit servers… sets your local per-server user and favorites.
• Default user — a fallback login user for servers that don't set their own (JSON and remote sources). Override it per server with the editor's Use default user toggle.

Table import

Generate the JSON from a CSV / Excel / Google-Sheets export — see Table import.

General

• Global hotkey — record a shortcut that opens ShuttleX centered on screen from anywhere (off by default). See The menu & the global hotkey.
• Launch at login — start ShuttleX automatically. For this to work reliably, run it from /Applications (see Installation).
• Enable server tags — adds an optional Tags field per server and small tag badges in the menu, and makes tags searchable (off by default). See Managing servers → Tags.
• Check for updates on launch — off by default. When on, ShuttleX checks the public GitHub Releases API at most once a day and shows a hint in the menu. No account, no tracking; it never auto-installs.
• Version — the running version (e.g. 1.14.0).