Skip to content

SckyzO/zsh-sshinfo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

sshinfo for Oh My Zsh πŸš€

License: MIT

sshinfo is a plugin for Oh My Zsh that enhances your ssh experience in two main ways:

  1. βœ… Connection Info Display: Before connecting, it shows you a clear, concise summary of the configuration that will be used (user, port, identity key, proxy, etc.). No more blind connections!
  2. ⚑️ Smart Autocompletion: It provides powerful and comprehensive Tab completion for all your SSH hosts.

✨ Features

  • Pre-connection Visualization: Displays connection details (User, HostName, Port, ProxyJump, etc.) right before the connection is established.
  • Comprehensive Autocompletion: Press Tab after ssh (or the s/connect aliases) to list all available hosts from:
    • Your ~/.ssh/config file.
    • All files included via the Include directive (even recursively!).
    • Your ~/.ssh/known_hosts file (while ignoring unreadable hashed hosts).
  • Convenient Aliases: Comes with s and connect aliases for even faster access.
  • Customizable: You can choose to override the base ssh command by uncommenting a line in the plugin.

πŸ› οΈ Installation

  1. Clone this repository into your Oh My Zsh custom plugins directory:

    git clone https://github.com/sckyzo/zsh-sshinfo.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/sshinfo
  2. Activate the plugin by adding it to the plugins list in your ~/.zshrc file:

    plugins=(... sshinfo)

    (Note: If you use the standard ssh plugin, make sure sshinfo is listed after it to ensure its autocompletion takes priority).

  3. Reload your Zsh configuration for the changes to take effect:

    omz reload

πŸš€ Usage

Simply use ssh, s, or connect as you normally would.

  • To see connection info:

    s my-remote-server

    Example Output (Note: You may want to replace this with a real screenshot of the plugin in action)

  • To use autocompletion:

    ssh <Tab>
    # or
    s my-remote-<Tab>

🀝 Contributing

Suggestions and contributions are always welcome! Feel free to open an issue or a pull request.


πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.

About

A Zsh plugin to display resolved SSH connection details before connecting.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages