Skip to content

User Guide Settings

Jump to bottom
github-actions[bot] edited this page Aug 21, 2026 · 6 revisions

Settings

Open Settings from the sidebar (gear icon).

Terminal

Setting Description
Color theme 44 built-in themes; visual picker grid
Font 7 bundled fonts (DejaVu, Meslo LGS, Inconsolata, Source Code Pro, Ubuntu Mono, Roboto Mono, MesloLGS NF)
Font size Adjust terminal font size

These three controls are also available without leaving the terminal: the tune icon in the terminal toolbar opens a right-side appearance panel with the same settings (changes apply live to all terminals).

Connection

Setting Default Description
Keep-alive interval 10 s Sends SSH keep-alive packets at this interval. Options: 10 s, 30 s, 60 s, 5 min, Disabled
Auto-reconnect attempts Unlimited (0) Number of reconnect attempts on disconnect. 0 = unlimited with linear back-off countdown

Auto-reconnect behavior

When the SSH connection drops, YourSSH automatically attempts to reconnect. With Unlimited selected, the countdown timer in the tab shows the back-off delay (increases linearly). To disable auto-reconnect, set the value to 1 or a specific number.

Hotkeys

All keyboard shortcuts are customizable. Click any shortcut row and press the new key combination. Changes take effect immediately.

Action Default
New session Cmd/Ctrl+N
Close session Cmd/Ctrl+W
Next session Cmd/Ctrl+]
Previous session Cmd/Ctrl+[
Toggle input bar Cmd/Ctrl+Shift+I
Split horizontal Cmd/Ctrl+Shift+H
Split vertical Cmd/Ctrl+Shift+V

AI

Enter API keys for AI providers:

Provider Key format
Anthropic Claude sk-ant-...
OpenAI sk-...
Google Gemini AIza...

Select the default model per provider. Keys are stored in the OS keychain.

Security

Shows where YourSSH keeps your host passwords, sudo passwords and key passphrases: the macOS Keychain, the Windows Credential Manager, or the system keyring on Linux. Everything else (host list, settings, known hosts) is plain configuration and lives in the app preferences.

  • Encrypted — every credential is in the OS secure store. This is the normal state.
  • Plain text — the OS secure store refused one or more credentials, so they were written to the app preferences file as readable text. Anything that can read your user account can read them. The row tells you how many, and Retry attempts to move them back into the secure store. A credential that cannot be moved is left where it is rather than deleted, and YourSSH retries automatically on the next launch.

The first time a credential has to be stored unencrypted, it is also reported in the notification bell, so the downgrade is never silent.

Secrets are always written to the secure store first and only fall back to preferences if that write fails — and a successful write purges any stale plain-text copy left over from an earlier version.

Sync

See Sync for full setup instructions.

Updates

YourSSH automatically checks GitHub for a newer stable release — on launch, every 6 hours while the app stays running, and whenever the window regains focus (all debounced to once per 24 hours) — so the notification bell picks up new releases even if you never restart the app. You can also trigger a manual check at any time via Settings → Updates → Check for updates.

  • When a newer version is found, a dismissible banner appears at the top of the app. You can dismiss it for the current version and it will not reappear until the next release.
  • The release also lands in the notification bell in the top tab bar (one item per version, with an inline Update button), so a dismissed banner doesn't mean a missed update. The bell additionally collects sessions that drop unexpectedly — opening the panel marks items read, and you can dismiss them individually or clear all.
  • Clicking Update (or Download & install) downloads the correct build for your OS and architecture and hands it off to your OS installer:
    • macOS — removes the com.apple.quarantine flag and opens the DMG. Complete the drag-to-Applications step yourself.
    • Windows — launches the installer .exe. Follow the setup wizard to complete the upgrade.
    • Linux — opens the .deb or .tar.gz with the default desktop file handler.
  • Because YourSSH is not code-signed, the final install step is always manual — the app never silently replaces itself.
  • If no build matches your platform (e.g. Intel Mac, where only Apple Silicon builds are published), the Releases page opens in your browser instead.

Plugins

Toggle Dart plugins (DevOps, Web Tools, Snippets) on or off. JS script plugins are managed via the Plugin Manager screen (sidebar → Plugins section).

Related Pages

  • Terminal — themes and fonts apply to the terminal
  • AI Chat — configure API keys here
  • Sync — cloud and P2P sync setup

Clone this wiki locally