ssh-config-manager

name	ssh-config-manager
description	Manage SSH host configurations in ~/.ssh/config from the terminal. Use when adding, editing, or searching SSH hosts, cloning host configs, testing connections, or importing configs. Triggers include "ssh config", "ssh host", "sshm", "add ssh host", "edit ssh config", "test ssh connection".

ssh-config-manager

CLI tool for managing ~/.ssh/config with CRUD operations, search, and connection testing.

Quick Start

# List all configured hosts
sshm list

# Show a host's details
sshm show web

# Add a new host
sshm add web --host example.com --user deploy

# Search hosts
sshm search deploy

# Test connectivity
sshm test web

Add Hosts

sshm add web --host example.com --user deploy
sshm add web --host example.com --user deploy --port 22
sshm add bastion --host bastion.corp.com --user ec2-user --identity ~/.ssh/corp_key

List and Show

sshm list                    # all hosts in table
sshm list --filter deploy    # filter by text
sshm show web                # all directives for host
sshm show web --raw          # show original raw config block
sshm show "*"                # show global Host * block

Edit Hosts

sshm edit web --user deploy           # update user
sshm edit web --host new.example.com  # update hostname
sshm edit web --port 2222             # update port
sshm edit web --identity ~/.ssh/new   # update identity file
sshm edit web --set ForwardAgent yes  # add/update any directive
sshm edit web --unset ForwardAgent    # remove a directive
sshm edit "*" --set ServerAliveInterval 120  # edit global defaults

Delete Hosts

sshm delete web           # with confirmation prompt
sshm delete web --yes     # skip confirmation

Search

sshm search deploy        # search aliases, hostnames, users
sshm search 10.0.0        # search by IP prefix
sshm search bastion       # fuzzy match

Test Connections

sshm test web             # test single host
sshm test --all           # test all hosts, show summary

Clone and Import

sshm copy web web-staging              # clone with new alias
sshm import ~/work-ssh-config          # import from another file

Backup and Restore

sshm backup               # manual backup to ~/.ssh/config.bak
sshm restore              # restore from backup (with confirmation)
sshm config               # show config path, host count, permissions

CLI Reference

Command	Description
list	List all hosts
show <alias>	Show host details
add <alias>	Add new host
edit <alias>	Edit host fields
delete <alias>	Delete host
search <query>	Fuzzy search
test <alias>	Test SSH connection
copy <from> <to>	Clone host config
import <file>	Import from config file
backup	Backup config now
restore	Restore from backup
config	Show config info

Environment Variables

Variable	Default	Description
SSHM_CONFIG_PATH	~/.ssh/config	SSH config file path
SSHM_BACKUP_DIR	~/.ssh/	Backup directory
SSHM_NO_COLOR	0	Disable ANSI color (1 to disable)
SSHM_DEBUG	0	Enable debug logging (1 to enable)

Exit Codes

Code	Meaning
0	Success
1	Host not found
2	Parse error in config file
3	Runtime error