ConfigSSH app icon
Open source · Native macOS · Local-first · Preview

ConfigSSH

Manage SSH config visually, connect in one click.

It reads and writes your ~/.ssh/config directly, with no separate host database. Changes are previewed as a diff and backed up before writing, and connections go through the terminal you already use. Without it, ssh, scp and VS Code Remote keep working as usual.

macOS 14+ · Apple Silicon · MIT licensed

ConfigSSH All Hosts page: a sidebar on the left, hosts grouped into Engineering and Personal in the middle with api highlighted, and that host's connection parameters and deploy-key entry on the right

All Hosts (demo data): browse by group, and see connection parameters and the raw config on the right. The app UI is in Chinese.

Your config stays yours, just easier to manage

Many SSH clients import your hosts into their own database, so you end up syncing two sets of config. ConfigSSH does not.

WhatA native macOS SSH config manager that reads and writes ~/.ssh/config and the files it Includes
ChangesA line-by-line diff before every save, an automatic backup before every write, and restore at any time
ConnectThe app only hands the request to your terminal; login is still done by the system OpenSSH, and SSH passwords are never stored
CompatibleWithout ConfigSSH, ssh, scp, VS Code Remote and other tools keep using the same config
StackNative Swift / SwiftUI app for macOS 14 Sonoma or later on Apple Silicon, MIT licensed

Manage, edit and connect from one window

Host management

Browse by group with search, favorites and collapsing. Create empty groups, or add a host right next to a group.

Safe editing

Edit HostName, User, Port, IdentityFile, ProxyJump and other common fields in a form, or edit the raw config. Diff preview before saving, backup before writing.

Quick connect

Double-click a host to connect. In any app, press the global shortcut ⌥⌘K or click the menu bar icon, search for a host and open the terminal.

Use your terminal

Terminal, Ghostty and Otty are detected automatically, other terminals can be configured by hand, and each host can open in a new window or a new tab.

Keys and key deployment

Index public keys and see which hosts use them, and generate Ed25519 / RSA keys. Enter a password once and the wizard installs the key on the server and switches the host to key login.

Snapshots and restore

Every change is backed up automatically. A config-only local snapshot is made daily by default (weekly or off if you prefer), or create one by hand and restore after previewing the diff.

Encrypted iCloud sync

Push your config to iCloud Drive encrypted, then preview and pull it on another Mac. The passphrase is never uploaded and private keys are not synced.

Conflicts never overwrite

The file version is checked again right before writing. If another program changed it in the meantime, the app keeps their version and reports a conflict.

Free and open source

MIT-licensed and written in Swift, with the source, tests and release process all on GitHub.

Three steps

Open the app

On launch it reads ~/.ssh/config and its Include files and groups hosts by source directory. This step only reads; it never writes.

Add or edit a host

Fill in the alias, address, user and port. You see the diff before saving, and nothing is written or backed up until you confirm.

Connect in one click

Double-click a host, or press ⌥⌘K to search, and the app opens ssh <alias> in your terminal.

Search anywhere, connect directly

No need to switch to the ConfigSSH window. The global shortcut and the menu bar icon both search hosts and open a terminal, and focus leaves your current app only after you pick a host.

Search box opened by the global shortcut: typing eng lists only hosts in the Engineering group, with the footer saying it will connect in a new Ghostty window
Global shortcut ⌥⌘K: type a keyword to filter hosts
Menu bar dropdown: with nothing typed it lists hosts by most recent connection, showing the address, group tag and default terminal
Menu bar icon: click it and search in the dropdown
ShortcutAction
⌥⌘KOpen the host search box from any app (rebind or turn off in Settings)
⌘KOpen the quick-connect panel in the main window
↑ ↓ ↩Pick a host in the search box and connect; sorted by recent connections when empty
⌘↩Open the selected host in a new tab
⌘NAdd a host
⌘RReload the config

The search box matches any part of the alias, address, user, display name, group or tag, with multiple keywords separated by spaces. The global shortcut only works while ConfigSSH is running, so turn on "Launch at login" too.

How your config is stored

A group is a subdirectory and each new host is its own file. Existing config is not migrated; it is read and shown as it is.

Directory layout

~/.ssh/
├── config              ← global options + Include entry
└── config.d/
    ├── api.conf        ← ungrouped host, one file each
    └── Work/           ← a group = a subdirectory
        └── staging.conf

A few conventions

  • config is only the entry point: the first time you add a host, the app inserts two lines such as Include config.d/*.conf before the Host rules and shows them in the preview.
  • Existing Host blocks are read and shown as they are; the app does not move them.
  • Deleting a group is previewed first and its hosts move to "Ungrouped"; on a name clash or unrecognized content it stops without overwriting any file.
Global Config page: a preview of the main config with the number of hosts, rules and files read, plus an edit button
Global config: view the main config and each Include file
Keys page: a sample Ed25519 public key selected, with its type, fingerprint, file path, private key status and linked hosts on the right
Keys: fingerprints, which hosts use them, and whether the private key exists

Safety and privacy

It touches your SSH config, so every step leaves room to back out.

What it does

  • Shows a line-by-line diff and saves a backup before writing (the last 50 are kept by default, adjustable).
  • Re-checks the file version before writing, and keeps the other program's version and reports a conflict if it changed.
  • Replaces files atomically and refuses to write symlinks or paths outside ~/.ssh.
  • Reads only .pub public key files when indexing keys.

What it never does

  • Never stores SSH passwords, and everyday use does not read private key contents into the app.
  • Never runs ssh -G automatically, because Match exec can run local commands.
  • Never rewrites complex config it cannot locate safely through the simple form; such hosts stay read-only.
  • Never uploads private keys to iCloud.

Local snapshots are not encrypted separately: manual snapshots contain only config files by default. To include private keys you must confirm once and tick each key; anyone who can read the snapshot files may get the keys, so set a passphrase on your private keys first.

Encrypted iCloud sync

Share one SSH config across several Macs, and only when you need it.

Encrypted on your Mac

Content is encrypted locally with AES-GCM, using a key derived from a shared passphrase you set (at least 12 characters). The passphrase is never uploaded.

One file per Mac

Each device has its own Devices/<device-id>.cssh in iCloud Drive, so they never overwrite each other.

Preview before pulling

Push and pull both show the file count and per-file diffs first; a pull only overwrites files at the same path, after a backup. Only config and the .conf files under config.d/ are synced.

Note: the app can only confirm a file was written to the local iCloud Drive folder, not that it reached the cloud, so check the sync status in Finder. If you lose the passphrase, the cloud copy cannot be decrypted. Absolute paths and IdentityFile locations may differ between Macs, so review them after pulling.

Download and install

Requires macOS 14 Sonoma or later on Apple Silicon (arm64). Connections use the OpenSSH that ships with macOS.

Preview: the pre-release package is neither signed nor notarized. It is for personal preview only, so please do not redistribute it. On first launch macOS warns that it cannot verify the developer.

Download the pre-release Recommended

Download ConfigSSH-vX.Y.Z-unsigned-macos-arm64.zip and SHA256SUMS.txt from the Releases page, put them in one folder and verify:

shasum -a 256 -c SHA256SUMS.txt

Unzip it and drag ConfigSSH.app into Applications. On first launch, open System Settings › Privacy & Security and click "Open Anyway" at the bottom of the page.

Go to Releases

Build from source

Requires the Swift 6 toolchain. Run it directly, or package it as an .app you can put in Applications:

git clone https://github.com/AlexWuYh/ConfigSSH.git
cd ConfigSSH
swift run ConfigSSH

# Package as .app
./scripts/package-macos.sh
open dist/ConfigSSH.app
View source
Terminal accessThe first time you launch through Terminal or Ghostty, macOS asks for Automation permission; choose Allow
Nothing happensCheck System Settings › Privacy & Security › Automation, and the terminal's detection status under Settings › Terminal in the app; a custom terminal needs the absolute CLI path and arguments containing {alias} or {ssh}
Made a mistakeFind the change under Settings › Config & Backups and restore it; the diff is shown before restoring as well
Known limitsThe static check in full-text editing cannot guarantee every OpenSSH option is valid on your system; only an Apple Silicon build is provided for now

Keep your SSH config in order

Free, open source, and your config stays on your own Mac.