# RSSH

[English](README.md) | [中文](README_zh.md)

**A genuinely different SSH client — built to fix the pain points everyone else ignored.**

> Traditional clients hand you a shell and stop there: endless scrollback, static IPs to memorize, copy-pasting logs into a chat bot.
> 
> RSSH goes further: commands become navigable blocks, containers are discovered live, and the AI reads the terminal like an operator.
> 
> Desktop · Mobile · JetBrains · CLI — one shared data store.

[![Release](https://img.shields.io/github/v/release/rssh-org/rssh)](https://github.com/rssh-org/rssh/releases/latest)
[![Downloads](https://img.shields.io/github/downloads/rssh-org/rssh/total)](https://github.com/rssh-org/rssh/releases)
![Platforms](https://img.shields.io/badge/macOS%20·%20Windows%20·%20Linux%20·%20Android·%20iOS-555)
[![License](https://img.shields.io/github/license/rssh-org/rssh)](LICENSE)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/rssh-org/rssh)

<p align="center">
  <img src="https://rssh.ofcoder.com/img_local.png" alt="RSSH — ask a question, the AI proposes commands, you approve before they run" height="180">
  <img src="https://rssh.ofcoder.com/img_blocks_context_menu.png" alt="Color-coded command blocks with their context menu" height="180">
  <img src="https://rssh.ofcoder.com/img_ai_panel.png" alt="RSSH — the AI panel reads the terminal and proposes commands for approval" height="180">  
</p>

<p align="center"><b><a href="https://github.com/rssh-org/rssh/releases/latest">⬇️ Download latest</a></b> &nbsp;·&nbsp; <a href="https://github.com/rssh-org/docs/blob/main/article_en.md">Why RSSH?</a></p>

---

## Why RSSH

<table>
<tr>
<td width="50%" valign="top">

### 🤖 AI triage
Not another chat box. Nothing to install on your servers — it works like a human operator, reading the terminal's input and output directly.

<img src="https://rssh.ofcoder.com/welcome-ai.gif" alt="AI triage: reads the terminal, proposes commands" width="400">

</td>
<td width="50%" valign="top">

### 🎨 Color-coded command blocks
Every command and its output become a block with a color-coded left edge — spot the last command's output at a glance. **Rendered fully locally**, zero remote dependency.

<img src="https://rssh.ofcoder.com/welcome-blocks.gif" alt="Color-coded command blocks" width="400">

</td>
</tr>
<tr>
<td width="50%" valign="top">

### 🐳 Dynamic discovery
Containers and pods change by the minute — connecting to servers by static IP is obsolete. RSSH dynamically discovers the containers in your local dev and test environments.

<img src="https://rssh.ofcoder.com/welcome-discovery.gif" alt="Dynamic discovery: containers appear live in Home" width="400">

</td>
<td width="50%" valign="top">

### 🔐 Multi-platform data sync
Keys stay in your local OS keyserver; connection configs are encrypted into your own private GitHub repo — nothing sits on a third-party server.

<img src="https://rssh.ofcoder.com/welcome-sync.gif" alt="Security and sync: keys in keychain, profiles encrypted to GitHub" width="400">

</td>
</tr>
</table>

---

## Features

- **SSH** -- password, private key, SSH agent/Pageant, keyboard-interactive, jump host (ProxyJump)
- **Telnet** -- saved profiles, echo negotiation, line controls, expect/send login scripts
- **Serial Console (desktop)** -- saved UART profiles, text/hex modes, flow control, login scripts, DTR/RTS/break
- **Dynamic Discovery (Docker/K8S)** -- discover Docker containers and running Kubernetes pods through local CLI contexts, then open ephemeral exec terminals
- **Terminal** -- xterm emulation, 10 000-line scrollback, foldable color-coded command blocks, regex highlighting, search
- **Multi-session Workbench (desktop)** -- live terminal previews and selection-aware broadcast across connected sessions
- **SFTP** -- remote file browser and upload/download
- **Port Forwarding** -- local, remote and dynamic (SOCKS5), named configs, real-time stats
- **Local Terminal (desktop)** -- auto-detect zsh/bash/PowerShell
- **Session Recording** -- asciicast v2 format, variable-speed playback
- **Connections & Credentials** -- SQLite storage, import from `~/.ssh/config`
- **Security & Sync** -- secrets encrypted locally with ChaCha20-Poly1305, master key in the platform keychain when available, selective remote sync, encrypted backup to your own GitHub repo or WebDAV server
- **Snippets** -- reusable command shortcuts (Cmd+E)
- **Mobile** -- virtual keybar (Ctrl/Alt/arrows/Tab/Esc), safe area, stack navigation
- **IDE Plugin** -- run RSSH inside JetBrains IDEs in a tool window (shared data dir)

## Install

Download from [Releases](https://github.com/rssh-org/rssh/releases):

| Platform            | File                                     | Notes                        |
|---------------------|------------------------------------------|------------------------------|
| macOS Apple Silicon | `rssh-{ver}-macos-aarch64.dmg`           |                              |
| macOS Intel         | `rssh-{ver}-macos-x86_64.dmg`            |                              |
| Linux (deb)         | `rssh-{ver}-linux-x86_64.deb`            | Debian/Ubuntu                |
| Linux (rpm)         | `rssh-{ver}-linux-x86_64.rpm`            | Fedora/RHEL                  |
| Linux (AppImage)    | `rssh-{ver}-linux-x86_64.AppImage`       | Any distro                   |
| Windows             | `rssh-{ver}-windows-x86_64.msi`          | Silent install: `msiexec /i` |
| Windows             | `rssh-{ver}-windows-x86_64-setup.exe`    | GUI installer                |
| Windows             | `rssh-{ver}-windows-x86_64-portable.zip` | Portable GUI + CLI           |
| Android (arm64)     | `rssh-{ver}-android-arm64.apk`           | 64-bit phones, 3x smaller    |
| Android             | `rssh-{ver}-android-universal.apk`       | All ABIs (emulators too)     |
| iOS                 |                                          | AppStore, by [@paradoxie](https://github.com/paradoxie) |

### IntelliJ / JetBrains plugin

Run the full RSSH UI inside a JetBrains IDE tool window — same hosts, keys and
settings as the desktop app (shared `~/.rssh`). Each zip bundles a headless
`rssh-server`, so it's self-contained and per-OS:

| Platform            | File                                             |
|---------------------|--------------------------------------------------|
| macOS Apple Silicon | `rssh-{ver}-macos-aarch64-jetbrains-plugin.zip`  |
| macOS Intel         | `rssh-{ver}-macos-x86_64-jetbrains-plugin.zip`   |
| Linux               | `rssh-{ver}-linux-x86_64-jetbrains-plugin.zip`   |
| Windows             | `rssh-{ver}-windows-x86_64-jetbrains-plugin.zip` |

Install: **Settings → Plugins → ⚙ → Install Plugin from Disk…**, pick the zip for
your OS and restart. Open the **RSSH** tool window (bottom) to start; the ✕ in its
title bar stops the embedded server.

## Development

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

MIT

## Friend Link

- [LINUX DO](https://linux.do/)