Home

SSHR - SSH Manager

SSHR is a modern, user-friendly Terminal User Interface (TUI) application designed to simplify SSH connection management. It provides an interactive interface to quickly connect to your configured SSH hosts without remembering complex command-line arguments.

Features

• Intuitive TUI interface for SSH connections
• Automatic loading of hosts from ~/.ssh/config
• Quick search and filter hosts
• Clean and responsive terminal interface
• Simple installation via Homebrew or direct download
• Cross-platform support (macOS & Linux)

UI Preview

Quick Start

1. Install SSHR (see Installation below)
2. Run sshr in your terminal
3. Use arrow keys to navigate and Enter to connect to a host
4. Type to filter hosts by name

Installation

Using Homebrew (Recommended)

brew tap hoangneeee/sshr
brew install sshr

Manual Installation

1. Download the latest release for your system:

# For macOS
curl -L -O https://github.com/hoangneeee/sshr/releases/download/latest/sshr-x86_64-apple-darwin.tar.gz

# For Linux
curl -L -O https://github.com/hoangneeee/sshr/releases/download/latest/sshr-x86_64-unknown-linux-gnu.tar.gz

2. Extract the archive:

tar -xvf sshr-*.tar.gz

3. Make the binary executable and move it to your PATH:

chmod +x sshr-*/sshr
sudo mv sshr-*/sshr /usr/local/bin/

Building from Source

git clone https://github.com/hoangneeee/sshr.git
cd sshr
make install

Usage

Basic Commands

sshr          # Launch the TUI interface
sshr --help   # Show help message
sshr --version # Show version information

Key Bindings

• ↑/↓ or j/k - Navigate through hosts
• Enter - Connect to selected host
• q or Ctrl+C - Exit SSHR
• Type to filter hosts by name

Contributing

We welcome contributions! Please feel free to submit issues and pull requests.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some 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 Apache License 2.0 - see the LICENSE file for details.

Related Projects

• SSH Config Parser - The underlying SSH config parser used by SSHR

Acknowledgements

• Built with Ratatui for the TUI interface
• Inspired by various SSH client tools in the Rust ecosystem

---

<sub>Built with ❤️ by hoangneeee


Need help or have questions? Open an issue or start a discussion
© 2025 SSHR. All rights reserved.</sub>