❯❯ ssh-host

Zsh plugin to simplify interaction with SSH config, ssh, scp.

Table of Contents

• Key Features
• Requirements
• Getting Started
• Key Bindings
• Troubleshooting

Key Features

Interactive Host Selection Browse hosts from .ssh/config with fuzzy search and live preview of connection details, port, key, and descriptions. Filter and navigate with keyboard.
Quick Host Setup Add new hosts through guided setup. Plugin automatically manages SSH config with Include directive, keeping your main config clean. Supports ed25519/RSA-4096 key generation with SSH agent integration, or password-based auth.
SCP Support Upload files/directories with ctrl-u, download with ctrl-d. Auto-detects recursive transfers for directories.
Pin Press ctrl-p to pin frequently-used hosts to the top of your list. Quick access to servers or most used environments.
Custom Descriptions Press ctrl-e to add descriptions to hosts. Document server purpose, environment (prod/staging/dev), or notes.

Requirements

• zsh >= 5.0
• fzf - Fuzzy finder for interactive selection

Getting Started

1. Install fzf

2. Install ssh-host:

   Zinit / Antigen / Znap

   Add to your ~/.zshrc:

   zinit load "obolientsev/ssh-host"
   # or
   antigen bundle obolientsev/ssh-host
   # or
   znap source "obolientsev/ssh-host"
   

   or

   Oh My Zsh

   1. Clone the repository:

   git clone https://github.com/obolientsev/ssh-host ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/ssh-host
   

   2. Add to your plugins list in ~/.zshrc:

   plugins=(ssh-host $plugins)
   

   3. Restart your shell:

   source ~/.zshrc
   

3. Launch the plugin:

   ssh-host
   

4. Follow the instructions to add your first host.

Key Bindings

Troubleshooting

Host problematic-host
    HostName example.com
    User myuser
    IdentityFile ...
    IdentitiesOnly yes  # Add this line

Host *
    IdentitiesOnly yes