ssh-config-manager

# ssh-config-manager

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

## Quick Start

```bash
# 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

```bash
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

```bash
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

```bash
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

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

## Search

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

## Test Connections

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

## Clone and Import

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

## Backup and Restore

```bash
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 |