🚀 SSHM - SSH Manager

A modern, interactive SSH Manager for your terminal 🔥

SSHM is a beautiful command-line tool that transforms how you manage and connect to your SSH hosts. Built with Go and featuring an intuitive TUI interface, it makes SSH connection management effortless and enjoyable.

✨ Features

🎯 Core Features

• 🎨 Beautiful TUI Interface - Navigate your SSH hosts with an elegant, interactive terminal UI
• ⚡ Quick Connect - Connect to any host instantly
• 📝 Easy Management - Add, edit, and manage SSH configurations seamlessly
• 🏷️ Tag Support - Organize your hosts with custom tags for better categorization
• 🔍 Smart Search - Find hosts quickly with built-in filtering and search
• 🔒 Secure - Works directly with your existing ~/.ssh/config file
• ⚙️ SSH Options Support - Add any SSH configuration option through intuitive forms
• 🔄 Automatic Conversion - Seamlessly converts between command-line and config formats

🛠️ Management Operations

• Add new SSH hosts with interactive forms
• Edit existing configurations in-place
• Delete hosts with confirmation prompts
• Backup configurations automatically before changes
• Validate settings to prevent configuration errors
• ProxyJump support for secure connection tunneling through bastion hosts
• SSH Options management - Add any SSH option with automatic format conversion
• Full SSH compatibility - Maintains compatibility with standard SSH tools

🎮 User Experience

• Zero configuration - Works out of the box with your existing SSH setup
• Keyboard shortcuts for power users
• Cross-platform - Supports Linux and macOS (Intel & Apple Silicon)
• Lightweight - Single binary with no dependencies

🚀 Quick Start

Installation

One-line install (Recommended):

curl -sSL https://raw.githubusercontent.com/Gu1llaum-3/sshm/main/install/unix.sh | bash

Alternative methods:

# Download specific release
wget https://github.com/Gu1llaum-3/sshm/releases/latest/download/sshm-linux-amd64.tar.gz

# Extract and install
tar -xzf sshm-linux-amd64.tar.gz
sudo mv sshm-linux-amd64 /usr/local/bin/sshm

📖 Usage

Interactive Mode

Launch SSHM without arguments to enter the beautiful TUI interface:

sshm

Navigation:

• ↑/↓ or j/k - Navigate hosts
• Enter - Connect to selected host
• a - Add new host
• e - Edit selected host
• d - Delete selected host
• q - Quit
• / - Search/filter hosts

The interactive forms will guide you through configuration:

• Hostname/IP - Server address
• Username - SSH user
• Port - SSH port (default: 22)
• Identity File - Private key path
• ProxyJump - Jump server for connection tunneling
• SSH Options - Additional SSH options in -o format (e.g., -o Compression=yes -o ServerAliveInterval=60)
• Tags - Comma-separated tags for organization

CLI Usage

SSHM provides both command-line operations and an interactive TUI interface:

# Launch interactive TUI mode for browsing and connecting to hosts
sshm

# Add a new host using interactive form
sshm add

# Add a new host with pre-filled hostname
sshm add hostname

# Edit an existing host configuration
sshm edit my-server

# Show version information
sshm --version

# Show help and available commands
sshm --help

🏗️ Configuration

SSHM works directly with your standard SSH configuration file (~/.ssh/config). It adds special comment tags for enhanced functionality while maintaining full compatibility with standard SSH tools.

Example configuration:

# Tags: production, web, frontend
Host web-prod-01
    HostName 192.168.1.10
    User deploy
    Port 22
    IdentityFile ~/.ssh/production_key
    Compression yes
    ServerAliveInterval 60

# Tags: development, database
Host db-dev
    HostName dev-db.company.com
    User admin
    Port 2222
    IdentityFile ~/.ssh/dev_key
    StrictHostKeyChecking no
    UserKnownHostsFile /dev/null

# Tags: production, backend
Host backend-prod
    HostName 10.0.1.50
    User app
    Port 22
    ProxyJump bastion.company.com
    IdentityFile ~/.ssh/production_key
    Compression yes
    ServerAliveInterval 300
    BatchMode yes

Supported SSH Options

SSHM supports all standard SSH configuration options:

Built-in Fields:

• HostName - Server hostname or IP address
• User - Username for SSH connection
• Port - SSH port number
• IdentityFile - Path to private key file
• ProxyJump - Jump server for connection tunneling (e.g., user@jumphost:port)
• Tags - Custom tags (SSHM extension)

Additional SSH Options: You can add any valid SSH option using the "SSH Options" field in the interactive forms. Enter them in command-line format (e.g., -o Compression=yes -o ServerAliveInterval=60) and SSHM will automatically convert them to the proper SSH config format.

Common SSH Options:

• Compression - Enable/disable compression (yes/no)
• ServerAliveInterval - Interval in seconds for keepalive messages
• ServerAliveCountMax - Maximum number of keepalive messages
• StrictHostKeyChecking - Host key verification (yes/no/ask)
• UserKnownHostsFile - Path to known hosts file
• BatchMode - Disable interactive prompts (yes/no)
• ConnectTimeout - Connection timeout in seconds
• ControlMaster - Connection multiplexing (yes/no/auto)
• ControlPath - Path for control socket
• ControlPersist - Keep connection alive duration
• ForwardAgent - Forward SSH agent (yes/no)
• LocalForward - Local port forwarding (e.g., 8080:localhost:80)
• RemoteForward - Remote port forwarding
• DynamicForward - SOCKS proxy port forwarding

Example usage in forms:

SSH Options: -o Compression=yes -o ServerAliveInterval=60 -o StrictHostKeyChecking=no

This will be automatically converted to:

    Compression yes
    ServerAliveInterval 60
    StrictHostKeyChecking no

🛠️ Development

Prerequisites

• Go 1.23+
• Git

Build from Source

# Clone the repository
git clone https://github.com/Gu1llaum-3/sshm.git
cd sshm

# Build the binary
go build -o sshm .

# Run
./sshm

Project Structure

sshm/
├── cmd/                 # CLI commands (Cobra)
│   ├── root.go         # Root command and interactive mode
│   ├── add.go          # Add host command
│   └── edit.go         # Edit host command
├── internal/
│   ├── config/         # SSH configuration management
│   │   └── ssh.go      # Config parsing and manipulation
│   ├── ui/             # Terminal UI components
│   │   ├── tui.go      # Main TUI interface
│   │   ├── add_form.go # Add host form
│   │   └── edit_form.go# Edit host form
│   └── validation/     # Input validation
│       └── ssh.go      # SSH config validation
├── install/            # Installation scripts
│   ├── unix.sh         # Unix/Linux/macOS installer
│   └── README.md       # Installation guide
└── .github/workflows/  # CI/CD pipelines
    └── build.yml       # Multi-platform builds

Dependencies

• Cobra - CLI framework
• Bubble Tea - TUI framework
• Bubbles - TUI components
• Lipgloss - Styling

📦 Releases

Automated releases are built for multiple platforms:

Platform	Architecture	Download
Linux	AMD64	sshm-linux-amd64.tar.gz
Linux	ARM64	sshm-linux-arm64.tar.gz
macOS	Intel	sshm-darwin-amd64.tar.gz
macOS	Apple Silicon	sshm-darwin-arm64.tar.gz

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Development Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Charm for the amazing TUI libraries
• Cobra for the excellent CLI framework
• The Go community for building such fantastic tools

---

Made with ❤️ by Guillaume

⭐ Star this repo if you found it useful! ⭐