Connecting to Hosts

Schooner opens SSH sessions in your terminal of choice. By default it targets Ghostty — but any terminal works.

From the menubar popover

Click the ⛵ icon → type to search → click a host or press Enter. Schooner runs ssh <alias> in a new Ghostty window (or tab, configurable in Settings).

Global keyboard shortcut

Press ⌘ Shift S from anywhere (even when Ghostty is in the foreground) to open the Schooner popover. The search box is focused automatically — just type and hit Enter.

The shortcut can be changed in Settings → General.

Terminal preference

Schooner supports:

• Ghostty (default, detected automatically)
• Terminal.app
• iTerm2
• Alacritty
• WezTerm
• Warp

Change the terminal in Settings → General → Terminal. If Ghostty is installed it is selected automatically on first launch.

New window vs. new tab

In Settings → General you can choose whether Schooner opens SSH sessions in a new window or a new tab in the current Ghostty window. The default is New window.

Danger-tag confirmation

If a host has a danger tag (default: prod, production) Schooner shows a confirmation dialog before opening the terminal. This is a last-chance safeguard against connecting to the wrong environment. The list of danger tags is configurable in Settings → Safety.

Frecency sorting

Every successful connection updates the host's frecency score (a blend of frequency and recency). The popover and TUI picker both sort by frecency, so the hosts you use most are always at the top without any manual reordering.