Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Your friendly SSH companion 🐢
A lightweight, local-first SSH configuration manager with smart diagnostics.
You don't need it. If you're comfortable editing config files and debugging SSH errors, you're all set.
But even power users waste time on:
| Scenario | Without SSH Buddy | With SSH Buddy |
|---|---|---|
| Permission denied (publickey) | Check key path → check permissions → check agent → check known_hosts → ... | Click "Diagnose" → see exactly what's wrong → one-click fix |
| "Is my RSA key still secure?" | ssh-keygen -l -f ~/.ssh/id_rsa + Google recommended bit length | Security tab shows warnings for weak keys automatically |
| New laptop, set up GitHub + GitLab + work accounts | Write 3 Host blocks, generate keys, copy pubkeys, test each... | Git Wizard: 2 min per account, guided step-by-step |
| "Which key am I using for what?" | cat ~/.ssh/config, try to remember | Visual list with tags, favorites, and search |
| Host key changed warning | Manually edit ~/.ssh/known_hosts line 47 | Click "Remove old key" → done |
SSH Buddy reads and writes to your actual ~/.ssh/config. No proprietary format, no lock-in. Stop using it anytime and your config still works.
Connect to GitHub, GitLab, or Bitbucket without memorizing SSH syntax.
- Choose platform → Select/generate key → Copy to platform → Done
- Supports multiple accounts (personal + work)
- Auto-generates proper ~/.ssh/config entries
When SSH connections fail, stop guessing.
- Preflight checks: Key exists? Permissions correct? SSH Agent running?
- Connection testing: Real SSH handshake with detailed error analysis
- One-click fixes: Fix permissions, add to SSH Agent, update known_hosts
Your config gets a health check.
- Weak key detection (DSA deprecated, RSA < 3072 bits)
- Permission audits (keys should be 600, not 644)
- Known hosts review (detect changed host keys)
- Algorithm warnings
All your SSH hosts in one place.
- Add, edit, delete hosts with a clean UI
- Smart templates for common setups (jump hosts, port forwarding)
- Tags and favorites for organization
- Change preview before saving
Overview all your SSH keys.
- Generate Ed25519 or RSA keys
- One-click copy public key
- Key details (type, bits, fingerprint)
Stay up to date without leaving the app.
- Check for new versions directly in settings
- Download and install updates with one click
- Release notes preview before updating
- 100% local: No accounts, no cloud sync, no telemetry
- Your keys stay on your device: We read ~/.ssh/, we don't upload anything
- Open source: Audit the code yourself
Manage all your SSH hosts with a clean, intuitive interface.
Get warnings about weak keys, permission issues, and security risks.
Connect to GitHub, GitLab, or Bitbucket in minutes with step-by-step guidance.
# Install via Homebrew
brew tap runkids/tap && brew install --cask ssh-buddyOr download the latest .dmg from Releases and drag to Applications.
Homebrew: Troubleshooting SHA256 mismatch errorsIf you encounter a SHA256 mismatch error during installation:
# Clear Homebrew's download cache and retry
brew cleanup ssh-buddy
brew install --cask ssh-buddy
# Or force reinstall
brew reinstall --cask ssh-buddyThis usually happens when Homebrew has a cached download from a previous version.
Download the latest .msi from Releases and run the installer.
Windows: Enable SSH Agent (required for full functionality)# Run PowerShell as Administrator
Get-Service ssh-agent | Set-Service -StartupType Automatic -PassThru | Start-ServiceOr: Services (services.msc) → OpenSSH Authentication Agent → Startup type: Automatic → Start
Built with Tauri + React + TypeScript + Tailwind CSS
pnpm install
pnpm dev:tauri # Development
pnpm tauri build # Production buildMIT