Skip to content

azlux/ssh-prompter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

42 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ssh-prompter

ssh-prompter lists all servers contained in your ssh_config file with search feature.

Additionally, the script can scan others Include ssh_config file if used.

This is a new version of this old script, rewrited in Go.

Screenshot

ssh-prompter

Installation

Via APT (recommended)

See http://packages.azlux.fr

echo "deb [signed-by=/usr/share/keyrings/azlux-archive-keyring.gpg] http://packages.azlux.fr/debian/ bookworm main" | sudo tee /etc/apt/sources.list.d/azlux.list
sudo wget -O /usr/share/keyrings/azlux-archive-keyring.gpg  https://azlux.fr/repo.gpg
sudo apt update
sudo apt install ssh-prompter

Manually

You need to install the Go Language

Then you can build the project

git clone https://github.com/azlux/ssh-prompter.git
cd ssh-prompter
go build

Configuration

Alias

Many people don't like the long command ssh-prompter so I recommand to put an alias into your ~/.profile or ~/.bashrc. It's safe to replace the ssh command since I don't interfere with ssh if additionnals parameters are used.

# alias ssh="ssh-prompter"
# or
# alias sshp="ssh-prompter"

SSH config configuration

Everything is here : Official ssh_config manual I don't have a custom config file, neither a database.

This program parse the standard ssh config file. See the example for a basic config for ssh

Folder

SSH-Prompter manage folder. Host will be group by Folder when no search.

Two methods:

  • The Host name can be FolderName/Name,
  • You can add the ssh config option Folder FolderName.
    • In this case you need IgnoreUnknown Folderon the TOP of your .ssh/config file (to avoid error).

You can use both (but not in the same time for the same Host) !

Additionnal information

All Host with * are ignored.

I consider we don't want to "select" them since it's a wildcard for other hosts

Why two methods for folder :

I first wanted to have the / (slash) method but when you use ProxyJump, ssh don't allow slash into the name. So the option Folder is here to allow having a proxy server into a folder.

TMUX

If you run the script on a tmux. The window will be renamed with the Host selected.

It use the command tmux rename-window xxxxx

About

๐Ÿ” Simple TUI to instantly search and SSH into servers from your ssh_config file

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages