ShellRS

A high-performance, native, cross-platform SSH client written in Rust, with a GPU-rendered interface: Xshell-style host management, WinSCP-style SFTP and port forwarding, all in one window.

简体中文 | English

About

ShellRS brings Xshell-style host management and tabbed terminals, a WinSCP-style dual-pane SFTP browser and SSH port forwarding together in one cross-platform app. It is written in Rust, and its UI is built on GPUI, the GPU-accelerated UI framework of the Zed editor (through gpui-kit). There is no Electron and no JVM.

Hosts, groups, credentials and forwarding rules live in a local SQLite database. Passwords and key passphrases go only into the system keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service); the database never holds a secret. ShellRS also ships a shellrs command that lets AI agents such as Claude Code or Codex run commands and transfer files on your saved hosts without ever seeing a password.

Note

ShellRS's interface is currently in Simplified Chinese only. An English translation is in progress.

Features

Hosts

• Groups nest to any depth; drag to rearrange, type to search.
• The remote OS is detected on connect and shown as a badge in the host tree and on tabs (Linux distributions, the BSDs, macOS, Windows).
• Three ways to log in: password; no password (the server's none auth, then the SSH agent, then the default keys in ~/.ssh); or a saved credential.
• Three ways to connect: directly, through a chain of SSH jump hosts, or through an HTTP or SOCKS5 proxy. Terminals, SFTP, port forwards and the CLI all follow it.
• "Test connection" performs a real login and explains any failure.

Terminal

• Tabbed remote and local terminals (built on alacritty_terminal); full-screen programs like vim and htop work as expected.
• Each tab shows the SSH round-trip latency live.
• Find (smart case) and local clear; configurable font, size and line height.
• Drag tabs into side-by-side or stacked splits to watch a terminal and SFTP together.

SFTP

• A dual-pane browser modeled on WinSCP Commander: symmetric local and remote panes with WinSCP's columns, path labels, bookmarks and shortcuts (F5, F2, F7, F8…).
• Upload and download by dragging or by shortcut, recursively. Start new transfers while one runs; they wait in a per-tab transfer queue.
• Resumable transfers: data goes to a .filepart first, dropped connections are retried after 1, 3 and 10 seconds, and after a restart ShellRS offers to resume the same transfer.
• Delete (local items go to the Trash), rename, create, and change permissions (a 3×3 grid plus octal, optionally recursive).
• Each SFTP tab has its own connection and asks only for the SFTP subsystem, so no shell is needed on the server.

Port forwarding

• Local (-L), remote (-R) and dynamic (-D, SOCKS5 / SOCKS4) forwards.
• The rule dialog draws a live diagram and a one-line explanation of where connections enter and where they go.
• Every rule keeps its own SSH connection and reconnects three times after a drop; rules can start with ShellRS.

Credentials

• Password, key and SSH agent credentials that many hosts can share. Change a credential and every host using it follows.
• Keys can reference a file on disk, be pasted in, or be generated on the spot (Ed25519 or RSA 4096), with the public key one click away.

A CLI for AI agents

• shellrs list / exec / upload / download. The running ShellRS logs in on the command's behalf, so the command itself never handles a password or private key.
• Install shellrs into your PATH and an Agent Skill for Claude Code, Codex, OpenCode or WorkBuddy from the settings page.

Security and updates

• Secrets stay in the system keychain. Host keys are recorded in ShellRS's own known_hosts, never in ~/.ssh.
• In-app updates: the update manifest is minisign-signed and each package is checked against its SHA-256. Updates download in the background and install on restart or quit. There are stable and beta channels, and an update check sends only the version, OS and CPU architecture.

Screenshots

Dock splits: a remote terminal and SFTP stacked in one window

WinSCP-style SFTP: highlight selection and a transfer queue with progress, speed and time left

Port forwarding: the diagram shows where each connection goes

Download

Download from shellrs.com/download, which offers the package for your system, or from GitHub Releases. Betas are marked Pre-release there; to get new features early, switch the update channel to Beta in Settings › About (设置 › 关于).

System	Package	Notes
macOS 11+ (Apple Silicon and Intel)	ShellRS-<version>-macos-universal.dmg	Signed and notarized. Open the DMG and drag ShellRS into Applications
Windows x64	ShellRS-<version>-windows-x86_64-setup.exe	Installs per user, no administrator rights needed. The installer is not signed yet; if SmartScreen stops it, choose "More info › Run anyway"
Linux x64	ShellRS-<version>-linux-x86_64.AppImage	chmod +x and run. Needs glibc 2.35 or newer (Ubuntu 22.04, Debian 12 and later)

Every package comes with a minisign signature (.minisig), and each release has a SHA256SUMS file.

Once installed, ShellRS keeps itself up to date: it checks, downloads and verifies new versions in the background, then shows an icon in the top-right corner of the title bar; click it and choose "重启并安装" (restart and install), or just quit and the update is installed on the way out. Automatic updates are unavailable when ShellRS runs from inside the DMG or outside the Applications folder, or on Linux when it isn't run as the AppImage.

Getting started

1. Click "新建主机…" (New host) in the title bar (⌘N, or Ctrl+N on Windows and Linux) and fill in the address, port and login. Passwords go into the system keychain.
2. Double-click a host to open a terminal. On the first connection you're asked to confirm the host key.
3. Right-click a host and choose "打开 SFTP" (Open SFTP), or click "SFTP" at the right of the terminal's tab bar. Drag files between the two panes to transfer them.
4. The three icons after "ShellRS" in the title bar switch the sidebar between hosts, port forwards and credentials.
5. ⌘T (Ctrl+T) opens a local terminal. Drag a tab to the top, bottom, left or right edge of the tab area to split it.

For AI agents

In 设置 › 外部 CLI (Settings › External CLI), turn on 启用外部 CLI (Enable external CLI), then install the shellrs command and the Agent Skills. Your agent can then use the hosts you have saved:

shellrs list                                       # list hosts and their IDs
shellrs exec <ID> "uptime && df -h"                # run a command; the exit code is the remote one
shellrs upload <ID> ./dist/app.tar.gz /opt/app/    # upload
shellrs download <ID> /var/log/syslog ./logs/      # download

The command hands each request to the running ShellRS, which logs in with the saved settings and keychain. An unknown host or a missing password fails right away with a stable error code instead of a prompt that would hang the agent. See the user manual (in Chinese) for details.

Building from source

Install rustup. The repository's rust-toolchain.toml pins Rust 1.98.1, which rustup installs on the first build.

git clone https://github.com/since2006/shell-rs.git
cd shell-rs
cargo run

The first build compiles the whole GPUI stack and takes a while. See development notes (in Chinese) for the Linux system packages and how to run the tests.

Documentation

The documentation is in Chinese for now:

• User manual: every feature in detail, with shortcuts
• Development: building, testing, the data directory
• Releasing: packaging, signing and publishing updates
• Changelog

Roadmap

Not implemented yet:

• An English interface (today only the text built into GPUI Kit's components switches language)
• Directory sync, filtering, file search and a directory tree in SFTP
• Keeping the Dock layout across restarts
• Combining a jump host chain with a proxy, and HTTPS proxies
• Managing port forwards and credentials through the external CLI
• Code signing for the Windows installer

Contributing

Issues and pull requests are welcome on GitHub. Architecture notes and code conventions are in CLAUDE.md (in Chinese). Before sending a change, make sure these pass:

cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo test

Acknowledgements

• GPUI (Zed) and gpui-kit: the UI framework
• russh and russh-sftp: SSH and SFTP
• alacritty_terminal and portable-pty: terminal emulation and local PTYs
• keyring: the system keychain
• Simple Icons: the OS logos on host badges and the Docker logo in the right sidebar (CC0)
• WinSCP and Xshell: the interaction designs ShellRS follows

License

ShellRS is licensed under the GNU General Public License v3.0. You may use, modify and redistribute it, commercially or not, but any modified version you distribute must come with its complete source code under the GPL-3.0 as well.