Native macOS menu-bar app for managing SSH connections. The app is the source
of truth: you manage hosts in Sesh, and it exports them to an app-owned
~/.ssh/sesh.conf that's linked into your ~/.ssh/config via a single
Include line. Your existing config is never rewritten.
- App-primary host management (create, edit, duplicate, delete) — the store is authoritative, not the file
- Automatic export to
~/.ssh/sesh.conf; a single idempotentIncludeline is added to~/.ssh/config(backed up first, existing blocks untouched) - Optional one-off Import from ~/.ssh/config to pull in existing hosts
- Connect via the
ssh://scheme —ssh://<alias>when the managed file is linked, elsessh://user@host:port; opened by your chosen ssh:// handler (Terminal, iTerm2, Warp, Zetty, or system default). The picker is derived from the installed apps that register thessh://scheme, so it stays current - Connection profiles: one host, multiple user+identity profiles (real ssh aliases); pick one from the Connect menu, menu bar, or ⌘K
- Workspaces to organize hosts into collapsible groups
- ⌘K command palette; searchable menu-bar panel; raw viewer of the managed file
- Light/Dark/System appearance and a tabbed Settings window
- Menu-bar-first app: the Dock icon appears only while a window is open
| Shortcut | Action |
|---|---|
| ⌘K | Command palette |
| ⌘N | New host |
| ⌘⇧N | New workspace |
| ⌘E | Edit selected host |
| ⌘↩ | Connect selected host |
| ⌘⇧C | Copy ssh command |
| ⌘D | Duplicate selected host |
| ⌘F | Focus search |
| ⌘, | Settings |
| ⌫ | Delete selection |
-
Open the Releases page and download the latest
Sesh-<version>.dmg. -
Open the DMG and drag Sesh into Applications.
-
Clear the Gatekeeper quarantine flag (see below), then launch Sesh from Applications or Spotlight:
xattr -d com.apple.quarantine /Applications/Sesh.app
Why step 3? Builds are not yet signed or notarized by Apple, so macOS quarantines the downloaded app and shows "Sesh is damaged and can't be opened." It isn't damaged — that's Gatekeeper's message for any unsigned download. The command above clears the flag on that copy; you won't see the dialog again until you install an update, where the freshly downloaded DMG repeats step 3. Developer ID signing + notarization is planned, which removes this step entirely.
Sesh lives in the menu bar (look for the terminal glyph). Click it to search and connect; open the main window from there to manage hosts.
Each release ships a Sesh-<version>.dmg.sha256 sidecar:
shasum -a 256 Sesh-<version>.dmg # compare against the .sha256 filemacOS 15.0 or later.
Sesh is open source under the MIT License.