An open API service indexing awesome lists of open source software.

https://github.com/hoangneeee/sshr

A TUI for managing and connecting to SSH hosts
https://github.com/hoangneeee/sshr

multi-platform rust shell ssh ssh-client ssh-manager ssh-manager-cli terminal

Last synced: 23 days ago
JSON representation

A TUI for managing and connecting to SSH hosts

Awesome Lists containing this project

README

          

# 💻 SSHR

SSHR is a TUI (Text User Interface) application for managing and connecting to hosts through the terminal interface.

[![Release](https://github.com/hoangneeee/sshr/actions/workflows/release.yml/badge.svg)](https://github.com/hoangneeee/sshr/actions/workflows/release.yml)

🎯 Supports: macOS & Linux (x86_64)

---

## 📚 Contents

- [UI Preview](#ui-preview)
- [Quick Start](#quick-start)
- [Installation](#installation)
- [Available Flags](#available-flags)
- [Keyboard Shortcuts](./docs/keyboard_shortcuts.md)
- [Contribute](#contribute)
- [License](#license)

---

## 🖥️ UI Preview

![image](./docs/preview_2.png)

## 🚀 Quick Start

- `sshr` automatically load hosts from your ~/.ssh/config
- Load customer host file with `hosts.toml` and template file [hosts.toml](./docs/hosts.toml)

## 📦 Installation

### 🍺 Install using Homebrew (recommended)

```bash
brew tap hoangneeee/sshr
brew install sshr
```

### ⬇️ Install from release

```bash
curl -L -O https://github.com/hoangneeee/sshr/releases/download/latest/sshr-x86_64-apple-darwin.tar.gz
# or
wget https://github.com/hoangneeee/sshr/releases/download/latest/sshr-x86_64-apple-darwin.tar.gz

# Unzip
tar -xvf sshr-x86_64-apple-darwin.tar.gz

# Copy to /usr/local/bin
sudo cp sshr-x86_64-apple-darwin/sshr /usr/local/bin/sshr
```

### 🔨 For Developer

```bash
git clone https://github.com/hoangneeee/sshr.git

cd sshr

make install
```

## 📝 Available flags

| Flag | Short flag | Description |
| ----------- | ---------- | ----------------------- |
| `--version` | `-V` | Current version of sshr |
| `--help` | `-h` | Show help |

## 🤝 Contribute

- If you want to contribute to this project, please fork this repository and create a pull request.
- If you want to report an issue or suggest an improvement, please create an issue.

## 📝 License

[Apache License 2.0](./LICENSE)