> changelog
Changelog
What changed in each ShellRS release.
Added
- SSH hosts can fill in one-time codes (TOTP). In the host dialog’s Advanced, turn on Fill in one-time codes and enter the OTP secret: when the server asks for a code during keyboard-interactive login, ShellRS sends the current 6-digit code. With Prompt to match left empty, it recognizes the usual prompts, such as Verification code, OTP and MFA. Terminals, SFTP, port forwarding, the external CLI, Test connection and jump hosts all fill it in. The OTP secret is stored only in the system keychain and syncs with cloud sync.
- Terminal background images: in Appearance, set one for light and one for dark, each with its own on switch and Transparency, and they follow the appearance. The image covers only the terminal; with split panes, each pane gets the whole image. (#43, #113)
- A Show host details button right of the search box in the host list: each host shows user@address:port under its name, and its notes on another line if it has any. Click it again for names only. ShellRS remembers the setting. (#116)
Improved
- A host that uses a credential can have its own username, so one private key logs in to servers with different usernames. Leave it empty to use the credential’s. ShellRS 0.1.18 and earlier still log these hosts in with the credential’s username. (#112)
- Highlighting comes with 11 preset rules, from the scheme a user shared in #113: errors, successes, warnings, IP and MAC addresses, sizes with units, dates and times, numbers and more, in colors that read well on the default light and dark backgrounds. If you hadn’t changed the three old examples, they’re replaced with the new presets; rules you changed stay.
- The left and right sidebars can be dragged narrower (to 180 and 220), and the widths you set stay after restarting. Settings › General › Window › Sidebar widths restores the defaults.
Fixed
- On macOS, holding down a key in a terminal showed the accent picker and typed the character once; it now repeats. (#114)
- With cloud sync on a ZSpace NAS’s WebDAV, setting up sync in an empty folder said another device had already turned on sync.
Added
- A menu bar on macOS, as in other Mac apps: ⌘H hides ShellRS, ⌥⌘H hides other apps and ⌘M minimizes the window. About ShellRS shows the version and a link to the website. (#88)
- The compose pane remembers the commands you send. Press ↑ and ↓ to go back through them as in a terminal, up to the last 500.
- Snippets are in the right sidebar next to local terminals too. Click one to type it into the local terminal.
Improved
- Snippet categories nest like host groups, and you can drag snippets and categories to reorder them. The list shows only names; hover over a snippet to see its command. Order and nesting sync with cloud sync; ShellRS 0.1.17 and earlier show every category at the top level, but don’t change the order or nesting elsewhere.
- On Windows and Linux, Close tab now defaults to Ctrl+Shift+W instead of Ctrl+W, as in Windows Terminal, so it works in a terminal too. Ctrl+W still goes to the shell. If you changed this shortcut, yours stays.
- The Follow switch in the right sidebar’s Files is remembered per host: Files opened for that host later, also after restarting ShellRS, start the way you last set it.
- The transfer queue scrolls to a new batch when it’s added.
Shared core for mobile
This release moves the desktop app's SSH connections, SFTP transfers, host and credential management, database persistence and cloud sync into Rust libraries independent of the interface. The desktop app now uses these shared cores, and Swift and Kotlin bindings let future iOS and Android clients use the same authentication, resumable transfers and end-to-end encrypted sync. The shared cores and mobile bindings are MIT licensed; the desktop app remains GPL-3.0-only.
Added
- App lock: require a password at startup, lock automatically after inactivity, and choose whether the external CLI remains available while locked. The lock settings and password verifier are kept in the system keychain.
- On Windows, “Minimize to tray on close” under Settings → General → Window keeps connections, transfers and port forwards running after the window is closed. Restore the window or quit from the tray. Off by default. (#83)
- Choose the terminal cursor's shape and whether it blinks under Settings → Terminal → Interaction.
- “Duplicate session” in a terminal tab's menu carries over its title and, for SSH terminals that report it, its working directory.
Improved
- The left sidebar remembers whether it was shown or hidden across launches.
- Open saved hosts directly from the title bar's Quick connect button. The sidebar toggle follows the panel's edge when resized, and the panel stays at least as wide as its default.
Fixed
- On macOS, waking from sleep or switching displays could crash ShellRS while the screen was temporarily unavailable.
- On Windows without the Visual C++ Redistributable, such as Windows 11 LTSC, ShellRS didn’t start: “VCRUNTIME140.dll was not found”.
Added
- Cloud sync: sync your data between computers, end-to-end encrypted (E2EE): it’s encrypted before it leaves this computer, so remote storage holds only ciphertext, and only devices with the password can read it.
- When the tabs don’t fit, scroll the tab bar sideways with the mouse wheel.
Fixed
- In a terminal, Home and End didn’t move to the start and end of the line when zsh on the server was set up with oh-my-zsh and the like.
Added
- Compose pane: write and edit commands below the terminal, several lines if you like, before sending them. Open it with ⌘⇧E (Ctrl+Shift+E on Windows and Linux) or from the terminal’s context menu. Command broadcast’s command bar is now the compose pane.
- Middle-click a tab to close it, as × does.
Improved
- On Windows the interface font size defaults to 14, the same size as the system’s own text.
- Importing hosts no longer lists hosts whose username is git, or the addresses of GitHub, GitLab and other code hosting services, which are for pushing and pulling code, not for logging in.
- With only one tab left, it still looks like a selected tab, as it does among others.
Fixed
- On Windows, the dialog of “Upload…” showed only folders, so no file could be chosen.
- In the Linux AppImage, commands such as cargo and rustc failed with “unknown proxy name” in a local terminal running zsh.
- When the computer was busy, files dropped on a remote terminal were sometimes asked for in a dialog instead of going up at once.
- In a terminal, typing with an input method after moving the cursor back into text already typed put the composition on top of the text after it, so neither could be read.
- The borders around the buttons at either end of the tab bar didn’t line up with the tab bar’s bottom line.
- The bottoms of letters such as g and p were cut off in tab names.
Added
- Projects in the right sidebar beside local terminals: keep local terminals in groups like hosts, and after reopening ShellRS carry on in the folders they were in.
- Terminals in Projects keep their last 1,000 lines of output when closed or when ShellRS quits, and show them when opened again; you can turn this off in Settings.
- Shift+Enter takes a new line in programs that support it, such as Claude Code, in local and remote terminals.
- Maximize window ⌃⌘↑ and Restore window ⌃⌘↓ shortcuts (macOS).
- A system-wide Show or hide ShellRS shortcut that works from any app; it has no keys until you set them in Settings › Keyboard shortcuts.
Improved
- The right sidebar remembers for each host whether it’s open and which tool it shows: open Files on a host, and it opens by itself whenever you connect to that host.
- In a terminal on Windows and Linux, Ctrl with a letter (such as tmux’s Ctrl+B) goes to the shell instead of triggering a ShellRS shortcut.
- The mouse pointer is an I-beam over a terminal’s text.
- A local terminal tab with a long title shows just the folder’s name.
- A long tab name ends in “…” instead of making the tab very wide.
- When importing hosts, hovering over a name, address or other value cut short shows all of it.
Fixed
- Box drawing such as the lines between tmux panes came apart into dashes in terminals.
- On small screens, such as a laptop at 150% scaling, the window ran off the screen the first time it opened.
- On Linux, GNOME and other desktops showed a generic app icon in the dock instead of ShellRS’s.
- When importing hosts, a long authentication name covered the Status column.
Added
- Import hosts from ~/.ssh/config and ~/.ssh/known_hosts: open it from the host list’s “…” menu or the context menu of its empty space, preview the hosts, tick the ones to import, and change each one’s name, group, username and authentication.
- Broadcast input: click the megaphone at the left of the tab bar and check a few terminals; they’re shown side by side, and the command bar above them sends a command to all of them. Turn on Sync keys to have typing in one go to the others too.
- Windows portable version: unzip and run, with all its data in the data folder next to the program; it updates itself too.
Improved
- After a remote terminal disconnects, Space closes the tab; Enter still reconnects.
- Less processor use in virtual machines without a graphics card (where the processor draws the interface): fewer frames while a terminal scrolls, a cursor that doesn’t blink, and no animations.
- In the Chinese interface, What’s new opens the changelog in Chinese.
Fixed
- Terminal text looked blurry at display scaling such as 150%.
- A terminal shown in a split popped up a reminder when its bell rang.
Added
- ZMODEM in the terminal: run rz or sz on the remote end to upload or download files, or drop files on a remote terminal to upload them.
- Telnet hosts, with automatic login, jump hosts and proxies.
- Serial hosts: connect to a serial port of this computer, with Test connection and Send break.
- Kubernetes in the right sidebar: browse cluster resources and container logs, edit YAML, restart and delete. Off by default; turn it on in Settings › Terminal › Sidebar tools.
- tmux in the right sidebar: list, create, attach, rename and end tmux sessions.
- GPU/NPU in the right sidebar: utilization, memory, temperature, power and compute processes of NVIDIA and Huawei Ascend cards. Off by default; turn it on in Settings › Terminal › Sidebar tools.
- Settings › Terminal › Sidebar tools: choose which tools the right sidebar shows.
- Interface font size in Settings › Appearance; outside the terminal, ⌘= / ⌘- change it.
- Select all, Copy IP and Copy ID in the terminal’s context menu.
Improved
- A host’s protocol can be changed when editing it.
- Editing or deleting a host no longer affects tabs already open; new tabs use the new settings.
- Host icons are always in color; a tab that is disconnected or connecting shows its icon and name in gray instead of a status dot.
- The status bar shows the current tab’s connection.
- SFTP transfers several files at once, so many small files upload and download faster; set how many in Settings › SFTP.
- System names, CPU models and the like that don’t fit in Monitor wrap instead of being cut off.
Fixed
- A bastion host’s ssh:// link with a / in the username connected to the wrong address.
- When a jump host couldn’t reach the target host, the error read as if the jump host itself had timed out.
- Dragging a selection past the top or bottom of the terminal didn’t scroll, so text off screen couldn’t be selected.
- After running programs such as ollama, 11;rgb:… appeared after the prompt.
- The Linux version didn’t open on older systems such as Ubuntu 20.04; glibc 2.31 or later is now enough.
Added
- Files in the right sidebar: browse, upload, download and edit remote files beside the terminal, over the terminal’s own connection, without logging in again.
- Files follows the terminal’s current folder; bash and zsh can be set up for it in one click.
- Find files on the remote side of SFTP.
- Color icons for SFTP file lists (Settings › SFTP › Icon style).
- Tabs show their connection: a yellow dot while connecting, a red one when disconnected. Press Enter in a disconnected remote terminal to reconnect.
Improved
- When a server’s host key changes, you can check the fingerprint and choose Update and connect, without editing known_hosts by hand.
- A host’s name can be left empty; its address is used instead.
Fixed
- On Windows, some bastion hosts set to use ShellRS as their Xshell or WinSCP client said “Please use the official client”.
- Tabs connected to Windows hosts didn’t show the Windows icon.
Added
- Local terminal in Settings › Terminal: choose the shell local terminals run, with its arguments; the list offers the common shells installed on this computer.
- Custom shortcuts can use Shift with Insert, Delete and similar keys, such as Shift+Insert to paste.
Improved
- On Windows, local terminals run PowerShell by default, and their tabs show only the program’s name.
- The Windows installer is in Chinese on Chinese systems.
- The app icon is the same size as other apps’ icons on macOS.
Added
- Interaction in Settings › Terminal: copy on select, and make right-click paste, show a menu or do nothing.
Improved
- macOS packages come separately for Apple silicon and Intel, so downloads are smaller.
Fixed
- On ESXi and similar hosts, Test connection said keyboard-interactive authentication was needed, and saved passwords didn’t work.
- Restart to update said a file couldn’t be found when updates were checked for soon after starting.
Added
- On Windows, the SFTP local folder list shows every drive, so you can switch to another one.
Improved
- Click a column title in SFTP file lists to sort by it.
Fixed
- Uploads through some bastion hosts failed, and saving in the editor dropped the SFTP connection.
- Columns widened by dragging in SFTP went back to their old width after changing folders.
Added
shellrs exec --terminalin the external CLI: runs a command in a terminal already open in ShellRS, for bastion hosts that allow logging in only once.- A scrollbar on the right of the terminal, to drag through earlier output.
Added
- An English interface: it follows the system language by default, or choose one in Settings › Appearance › Language; changes apply at once.
- An English user manual; the README shows the English version by default.
- Anonymous usage statistics, which can be turned off in Settings › About › Privacy.
Improved
- The default dark appearance is a softer charcoal gray.
- Hovered and selected rows in lists are easier to tell apart.
- With split panes, the right sidebar follows the remote terminal you click into, and its title shows the host’s name.
- Docker tabs that don’t fit scroll sideways instead of being cut off.
Fixed
- The right sidebar closes once a tab dragged into another group covers the terminal.
Added
- Terminal themes: 10 color schemes each for the light and dark appearance, and the interface can take the theme’s colors too.
- Keyword highlighting in the terminal: color the text that matches your rules, and get a notification when one matches if you like.
- Keyboard shortcuts in Settings: view, rebind, disable or restore shortcuts, with new shortcuts to switch tabs.
- In the terminal, ⌘= / ⌘- / ⌘0 (Ctrl on other platforms) change the terminal font size; outside it, they zoom the interface.
- Settings › General: remember the window’s size and position.
- Settings › About: a link to the website.
- The external CLI can list, create, change and delete hosts and credentials (
shellrs hosts,shellrs credentials), and sync folders withshellrs sync.
Improved
- Searching the host list also finds group names.
- Settings stays on its category when you switch to another tab and back.
- The terminal font size ranges from 10 to 28.
- The external CLI lists hosts with
shellrs hosts list.
Fixed
- The terminal no longer freezes when a remote program stops halfway through a frame.
Added
- A built-in editor for SFTP: double-click a text file to edit it in an editor tab, and ⌘S saves it straight back to the server, with syntax highlighting for common languages.
- SFTP preview: double-click an image for a quick look, and zoom in, zoom out or see it at actual size; right-click Markdown and SVG files and choose Preview.
- Show hidden files in SFTP, separately for the local and remote sides.
- Copy path in the SFTP context menu.
- Web addresses in the terminal show as links; ⌘-click (Ctrl-click on other platforms) opens them in the browser.
- Mouse support in the terminal: click and scroll in vim, htop and tmux.
- What remote programs (such as tmux and vim) copy goes straight to this computer’s clipboard.
- Terminal notifications: when a program asks for a notification or rings the bell while ShellRS isn’t in front, you get a system notification.
shellrs exec --jsonin the external CLI: no more quoting trouble or garbled text in Windows PowerShell.
Improved
- The context menu of SFTP folders no longer has a needless Open; double-click to go in.
Added
- Quick connect: Quick connect… at the top right of the title bar connects to a host without saving it, keeping the password in memory only (to add a host, use + in the host list or ⌘N).
- Find a host on the start page: search the saved hosts, then press Enter or click to connect.
Improved
- Test connection no longer needs a password; without one, it tries the way No password does.
Improved
- A shorter skill description for AI agents.
The first public release of ShellRS.
Added
- Hosts and groups: saved, with groups nested to any depth, search, and dragging to arrange them.
- Credentials: passwords, keys (a file on this computer, pasted or newly generated) and the SSH agent; several hosts can share one credential.
- Connections: direct, through jump hosts, or through an HTTP / SOCKS5 proxy.
- Terminals: local terminals and multiple SSH terminals, with find, clear and latency.
- The right sidebar: Monitor, Network, Processes, Services, Docker, History and Snippets for the current remote terminal.
- SFTP: a WinSCP-style dual-pane file browser, with resumable uploads and downloads and a transfer queue.
- Port forwarding: local, remote and dynamic, reconnecting after a drop, and able to start with ShellRS.
- Opening from bastion hosts: open a terminal or SFTP with
ssh://andsftp://links, as with Xshell and WinSCP, without saving the connection. - The external CLI: the
shellrscommand lets AI agents run commands and transfer files with the saved hosts. - Online updates: new versions are checked for and downloaded in the background, announced at the top right of the title bar, and installed on restart or quit.