ssh-config-manager

# SSH Config Manager

## What This Does

A CLI tool to manage SSH configuration files (`~/.ssh/config`). It helps you organize SSH hosts, generate configurations, test connections, and keep your SSH config clean and maintainable.

Key features:
- **Parse and display** existing SSH configs in readable format
- **Add/remove/edit** hosts in your SSH config
- **Organize hosts** with tags, groups, or categories
- **Test SSH connections** to verify hosts work
- **Generate configs** from templates or JSON/YAML input
- **Validate syntax** to ensure config files are correct
- **Backup and restore** your SSH config before making changes

## When To Use

- Your `~/.ssh/config` file has become messy with dozens of hosts
- You need to quickly test if SSH connections work
- You want to share SSH configs with team members
- You frequently switch between different environments (work/home/cloud)
- You want to organize hosts by project, environment, or team
- You need to validate SSH config syntax before applying changes

## Usage

Basic commands:

```bash
# List all hosts in your SSH config
python3 scripts/main.py list

# Add a new host
python3 scripts/main.py add --host myserver --hostname 192.168.1.100 --user admin

# Test SSH connection to a host
python3 scripts/main.py test --host myserver

# Organize hosts by tags
python3 scripts/main.py organize --tag work --hosts server1,server2,server3

# Generate SSH config from YAML template
python3 scripts/main.py generate --template servers.yaml --output ~/.ssh/config

# Validate SSH config syntax
python3 scripts/main.py validate --file ~/.ssh/config
```

## Examples

### Example 1: List and organize hosts

```bash
python3 scripts/main.py list --format table
```

Output:
```
┌─────────────────┬──────────────────────┬───────────┬───────────────┐
│ Host            │ Hostname             │ User      │ Tags          │
├─────────────────┼──────────────────────┼───────────┼───────────────┤
│ github          │ github.com           │ git       │...

# SSH Config Manager

A CLI tool to manage SSH configuration files (`~/.ssh/config`). Organize hosts, generate configs, test connections, and keep your SSH config clean.

## Installation

Install via ClawHub:

```bash
clawhub install ssh-config-manager
```

## Usage

```bash
# List all hosts
python3 scripts/main.py list

# Add a new host
python3 scripts/main.py add --host myserver --hostname 192.168.1.100 --user admin

# Test SSH connection
python3 scripts/main.py test --host myserver

# Validate config syntax
python3 scripts/main.py validate

# Remove a host
python3 scripts/main.py remove --host myserver
```

## Features

- Parse and display SSH configs in readable format
- Add, edit, remove hosts
- Test SSH connections with timeout
- Validate config syntax
- Backup before making changes
- Organize hosts with tags (basic)

## Requirements

- Python 3.x
- SSH client installed

## Limitations

- Basic syntax validation
- Connection testing requires SSH keys setup
- Does not manage SSH keys
- Limited to standard SSH config options

## License

MIT