SSHarbor

⚓ Your safe harbor for SSH connections

"Managing 30 servers? There's a better way than history | grep ssh"

Stop drowning in terminal windows. Organize your servers. Navigate with confidence.

🌊 Lost at Sea?

You're a developer. You have dozens of servers. Production, staging, dev boxes, client machines, personal projects...

Every time you need to connect:

• 🔍 "What was that IP again?"
• 🤔 "Which SSH key does this server use?"
• 😤 "Let me scroll through my bash history..."
• 🤯 "Was it port 22 or 2222?"

Sound familiar?

⚓ Find Your Harbor

SSHarbor transforms chaos into clarity:

🧭 Who Sails with SSHarbor?

✨ Features That Ship

🚢 Organize with Fleets

Group servers into logical Fleets — Production, Staging, Personal, Client-A, whatever makes sense for your workflow.

📦 Production
   └── 🚢 Web Server
   └── 🚢 Database
   └── 🚢 Redis Cache

📦 Development
   └── 🚢 Dev Box
   └── 🚢 Test Server

📦 Personal
   └── 🚢 Home Lab
   └── 🚢 Raspberry Pi

⚡ Quick Connect — Cmd+Shift+S

⌘ + ⇧ + S — and you're in.

Search across all your vessels, or type a quick connection string. No more terminal archaeology.

🚀 Board the Vessel — VS Code Remote SSH

Click Board the Vessel and SSHarbor opens a new VS Code window connected to your server via Remote SSH. Full IDE experience. No terminal juggling.

📂 Quick Access Folders

SSHarbor remembers the folders you work in. Next time you connect, pick your project folder instantly — no navigation required.

⭐ Favorites

Star your most-used servers. They float to the top, always within reach.

🔑 Smart SSH Key Management

Configure SSH keys per-fleet or per-vessel. SSHarbor handles the complexity:

{
  "defaults": { "identityFile": "~/.ssh/id_rsa" },
  "fleets": [{
    "name": "AWS Production",
    "defaults": { "identityFile": "~/.ssh/aws-prod.pem" }
  }]
}

🎯 Rich Detail Panel

Select any vessel to see:

• Connection details at a glance
• SSH command preview
• Quick action buttons
• Saved folders for instant access

📋 Copy & Go

Right-click → Copy SSH Command → Paste anywhere. Perfect for sharing with teammates or documentation.

🤔 "But I Already Use..."

🚀 Quick Start

1. Install

Open VS Code → Extensions → Search "SSHarbor" → Install

Or via command line:

code --install-extension marcostullyo.ssharbor

2. Create Your First Fleet

Click the + button in the SSHarbor panel, or run:

⌘ + ⇧ + P → SSHarbor: Create Fleet

3. Add Your Vessels

Right-click your fleet → Commission New Vessel

Enter host, user, port — done.

4. Connect!

Click on any vessel → Board the Vessel 🚀

⚙️ Configuration

SSHarbor stores configuration in VS Code's global storage. Edit via the ⚙️ icon or:

⌘ + ⇧ + P → SSHarbor: Edit Configuration

Example Configuration

{
  "$schema": "./schema.json",
  "defaults": {
    "user": "root",
    "port": 22,
    "identityFile": "~/.ssh/id_rsa"
  },
  "fleets": [
    {
      "name": "Production",
      "icon": "cloud",
      "defaults": {
        "user": "deploy",
        "identityFile": "~/.ssh/prod.pem"
      },
      "vessels": [
        {
          "name": "Web Server",
          "host": "web.example.com",
          "tags": ["nginx", "frontend"],
          "favorite": true
        },
        {
          "name": "Database",
          "host": "db.example.com",
          "port": 5432,
          "tags": ["postgres"]
        }
      ]
    },
    {
      "name": "Development",
      "icon": "beaker",
      "vessels": [
        {
          "name": "Dev Box",
          "host": "192.168.1.100",
          "user": "developer",
          "notes": "Local development machine"
        }
      ]
    }
  ]
}

Configuration Reference

⌨️ Keyboard Shortcuts

🎯 Commands

🗺️ Roadmap

• [x] Fleet organization
• [x] Quick Connect (Cmd+Shift+S)
• [x] VS Code Remote SSH integration
• [x] Favorites & tags
• [x] Quick access folders
• [ ] 🔜 Import from ~/.ssh/config
• [ ] 🔜 Team sharing (JSON export/import)
• [ ] 🔜 Connection health monitoring
• [ ] 💭 Multi-hop (Jump Host) support
• [ ] 💭 SFTP browser integration

💬 What Developers Are Saying

"Finally, a sane way to manage my AWS fleet" — DevOps Engineer

"Onboarding new team members went from hours to minutes" — Tech Lead

"My terminal history thanks you" — Full Stack Developer

"The nautical theme is surprisingly intuitive" — Homelab Enthusiast

💡 Pro Tips

1. Use fleet defaults — Set user/key once per fleet, not per vessel
2. Tag everything — Makes searching lightning fast
3. Star your top 5 — Favorites always float to the top
4. Save folders — SSHarbor remembers where you work

🆘 Quick Troubleshooting

code --install-extension ms-vscode-remote.remote-ssh

❌ ~/.ssh/key.pem
✅ /Users/yourname/.ssh/key.pem

🤝 Contributing

Found a bug? Have a feature idea?

1. Open an issue
2. Fork & submit a PR
3. Star the repo ⭐

📄 License

MIT — Use it, modify it, ship it.

🚀 Ready to dock your connections?

⚓ Made with love for developers who live in the terminal

_{🌟 If SSHarbor saved you time, consider starring the repo!}

_{Built by Marcos Tullyo @ Markfields Solutions}

☕ Support me on Ko-fi