sshinfo
is a plugin for Oh My Zsh that enhances your ssh
experience in two main ways:
- β 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!
- β‘οΈ Smart Autocompletion: It provides powerful and comprehensive
Tab
completion for all your SSH hosts.
- Pre-connection Visualization: Displays connection details (User, HostName, Port, ProxyJump, etc.) right before the connection is established.
- Comprehensive Autocompletion: Press
Tab
afterssh
(or thes
/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).
- Your
- Convenient Aliases: Comes with
s
andconnect
aliases for even faster access. - Customizable: You can choose to override the base
ssh
command by uncommenting a line in the plugin.
-
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
-
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 suresshinfo
is listed after it to ensure its autocompletion takes priority). -
Reload your Zsh configuration for the changes to take effect:
omz reload
Simply use ssh
, s
, or connect
as you normally would.
-
To see connection info:
s my-remote-server
(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>
Suggestions and contributions are always welcome! Feel free to open an issue or a pull request.
This project is licensed under the MIT License. See the LICENSE file for details.