A powerful and visually elegant Zsh plugin that summarizes your SSH connection details before connecting.
- Pixel Perfect UI: Clean, modern summary with Unicode borders and 256-color support.
- Recursive Tunnel Discovery: Automatically resolves full ProxyJump/ProxyCommand chains.
- Dynamic Route Styles: Choose between a vertical Staircase view or a compact Inline view.
- IP Resolution: Automatically resolves hostnames to real IP addresses.
- Smart Completion: Advanced tab-completion that follows
Includedirectives and parsesknown_hosts. - Non-Invasive: Wraps
sshbut stays out of your way for simple commands.
Using Oh My Zsh
- Clone the repository into your custom plugins folder:
git clone https://github.com/SckyzO/zsh-sshinfo.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/sshinfo - Add
sshinfoto your plugins list in~/.zshrc:plugins=(... sshinfo)
- Restart your shell or run
omz reload.
You can set the default route display style by exporting ZSH_SSHINFO_STYLE in your .zshrc:
# Default is "staircase"
export ZSH_SSHINFO_STYLE="inline"You can override the style directly on the command line:
ssh --inline my-host # Force compact view
ssh --staircase my-host # Force tree view SSH Connection to production-db
╭── CONNECTION
│ 👤 User : root
│ 🌐 Host : 10.0.5.2 (10.0.5.2)
│ 🔌 Port : 22
│
├── SECURITY
│ 🔑 Key : ~/.ssh/id_ed25519
│
├── NETWORK PATH
│ 🛤️ Route : bastion [194.57.10.1]
│ ╰─> production-db [10.0.5.2]
│
╰───────────────────────────────────────────
├── NETWORK PATH
│ 🛤️ Route : bastion [194.57.10.1] ➜ production-db [10.0.5.2]
- Zsh
- Nerd Fonts (recommended for icons like , 👤, 🌐)
- ssh (OpenSSH)
This project is licensed under the MIT License.