ssm

command module
v0.1.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 14, 2025 License: MIT Imports: 5 Imported by: 0

README

Malathair's Simple SSH Manager

Version Go Reference Go Report Card MIT License


About the Project

SSM is a CLI utility that attempts to provide a better SSH experience by providing a wrapper for OpenSSH's ssh command. It does so through a simplified interface with some sensible defaults that automatically generates and executes OpenSSH's ssh command in the background. The defaults chosen by SSM can be overridden for all hosts using a TOML based configuration file, or on a per-host basis through flags.

This tool also provides some additional functionality that is difficult or impossible to achieve through a typical SSH config file. This includes functionality such as dynamic FQDN completion and password autofill through the use of sshpass.

This is a port/re-imagining of my original Python implementation which can be found here: Malathair's Python Simple SSH Manager


Getting Started

Prerequisites

Additional software needed to use SSM

  • OpenSSH SSH client
Installation

SSM can be installed by running the installer script:

curl https://raw.githubusercontent.com/malathair/ssm/refs/heads/main/install.sh | sh

Or by downloading the latest precompiled binary

Configuration

SSM expects the configuration file called ssm.conf to exist in the current working directory or in the user's config home dir.

An example configuration file can be found here: examples/ssm.conf


Updating

To update SSM, simply copy the latest ssm binary over the existing binary on your system. This can be done by either running the installer script, or by downloading the latest precompiled binary


Uninstalling

SSM can be uninstalled by running:

rm $(which ssm)

Documentation

Overview

Simple SSH Manager (SSM) is a program to simplify the act of SSH'ing into remote hosts

SSM does this by providing a wrapper interface to the underlying OpenSSH command. This allows shorthand specification for options that are frequently used but can otherwise be quite verbose when using OpenSSH directly. Where possible, an OpenSSH config file should be used, as this tool aims to provide a simplified interface for options that need to be dynamic, or are not supported by the OpenSSH config file.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL