Skip to content

runkids/ssh-buddy

Repository files navigation

SSH Buddy

SSH Buddy

Your friendly SSH companion 🐒

A lightweight, local-first SSH configuration manager with smart diagnostics.

Download latest release

macOS Windows License Release


"I know ~/.ssh/config. Why do I need this?"

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.


✨ Key Features

πŸ”— Git Platform Wizard

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

🩺 Smart Diagnostics

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

πŸ›‘οΈ Proactive Security

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

πŸ–₯️ Visual Host Management

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

πŸ”‘ Key Management

Overview all your SSH keys.

  • Generate Ed25519 or RSA keys
  • One-click copy public key
  • Key details (type, bits, fingerprint)

πŸ”„ In-App Updates

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

πŸ”’ Privacy First

  • 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

πŸ“Έ Screenshots

Visual Host Management

Manage all your SSH hosts with a clean, intuitive interface.

Hosts view

Proactive Security Scanning

Get warnings about weak keys, permission issues, and security risks.

Security view

Git Platform Wizard

Connect to GitHub, GitLab, or Bitbucket in minutes with step-by-step guidance.

Wizard view


πŸ“¦ Installation

macOS

# Install via Homebrew
brew tap runkids/tap && brew install --cask ssh-buddy

Or download the latest .dmg from Releases and drag to Applications.

Windows

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-Service

Or: Services (services.msc) β†’ OpenSSH Authentication Agent β†’ Startup type: Automatic β†’ Start


πŸ› οΈ Development

Built with Tauri + React + TypeScript + Tailwind CSS

Prerequisites

Setup

pnpm install
pnpm dev:tauri      # Development
pnpm tauri build    # Production build

⭐ Star History

Star History Chart


πŸ“„ License

MIT

About

🐒 A lightweight, local-first SSH configuration manager with smart diagnostics.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published