/sshm

SSH Manager (sshm) is a bash script that simplifies and automates the management of SSH hosts through the SSH configuration file (`~/.ssh/config`). It provides functionalities to list, connect, view, add, edit, and delete SSH host configurations, as well as to check the availability of hosts using pings.

Primary LanguageShellApache License 2.0Apache-2.0

SSH Manager (sshm)

SSH Manager (sshm) is a bash script that simplifies and automates the management of SSH hosts through the SSH configuration file (~/.ssh/config). It provides functionalities to list, connect, view, add, edit, and delete SSH host configurations, check the availability of hosts using pings, and manage different SSH configuration contexts.

Features

  • List all SSH hosts in the configuration file.
  • Connect to an SSH host by number or name.
  • View the configuration details of a specific SSH host.
  • Add a new SSH host configuration.
  • Edit an existing SSH host configuration.
  • Delete an SSH host configuration.
  • Check the availability of an SSH host using ping.
  • Manage multiple SSH configuration contexts.

Requirements

  • Bash
  • SSH
  • awk
  • sed
  • ping

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/sshm.git
cd sshm

  2. Make the script executable:

    chmod +x sshm

  3. Move the script to a directory in your PATH, for example:

    sudo mv sshm /usr/local/bin/

Usage

List SSH Hosts

sshm list

Connect to an SSH Host

sshm connect <name>

View SSH Host Configuration

sshm view <name>

Add a New SSH Host Configuration

sshm add

The script will prompt you to enter the host details.

Edit an Existing SSH Host Configuration

sshm edit <name>

The script will prompt you to enter the new details for the host.

Delete an SSH Host Configuration

sshm delete <name>

Check SSH Host Availability

sshm ping <name>

Manage SSH Contexts

List Available Contexts

sshm context list

This will list all available SSH configuration contexts and highlight the currently active one.

Switch to a Different Context

sshm context use <context_name>

Switches the active SSH configuration to the specified context.

Create a New Context

sshm context create <context_name>

Creates a new SSH configuration context.

Delete a Context

sshm context delete <context_name>

Deletes the specified SSH configuration context.

Example

Adding a New SSH Host

sshm add

You will be prompted to enter the following details:

  • Host name
  • HostName (IP address or domain)
  • User (default: current user)
  • Port (default: 22)
  • IdentityFile (default: ~/.ssh/id_rsa)

Editing an Existing SSH Host

sshm edit myhost

You will be prompted to update the details for the host myhost.

Viewing a Host Configuration

sshm view myhost

Checking Host Availability

sshm ping myhost

Switching to a Different SSH Context

sshm context use myconfig

Switches to the myconfig SSH configuration context.

License

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

Contributing

Contributions are welcome! Please open an issue or submit a pull request.