更新日志Changelog

Release history, listed per platform. Each edition versions independently — the same v1.x on different platforms does not mean the same changes.

Apple · iPhone / iPad / Mac

Live on the App Store; history is also available under "Version History" in the store.

v2.0.0 · September 2026

A new macOS capability — external agents — plus a focused fix pass on the terminal in full-screen programs.

• External agents (macOS): a new MCP service exposes the hosts you have already configured to AI coding tools on your desktop (claude-code, codex and the like), without them needing your passwords, private keys or jump-host setup. Everything exposed in this release is read-only — list hosts, run read-only commands, read remote files, fetch metrics; mutating commands are refused, with the reason given. It listens on this machine only, checks a token on every request, keeps that token in the Keychain, and records every call in an audit log; sessions you already have open are reused. Settings ▸ External Agents gives you the connection command, ready to copy. Full details →
• Terminal scrolling: scrolling finally works in tmux, vim and less — the wheel and swipes previously did nothing at all, even with mouse on enabled in tmux; on iPhone and iPad you can swipe to scroll in full-screen programs too
• Input (iPhone & iPad): sticky Alt on the shortcut bar — word-wise cursor movement (Alt+B / Alt+F) and the last argument of the previous command (Alt+.) now work; a new ⌥↩ key for newlines inside command-line programs that take multi-line input; and a new key
• Battery: going to the background is reported to the remote program, which pauses its animations and redraws
• Security: sync and pairing codes now draw from the system cryptographic random source, and no longer continue silently if it is unavailable
• Fixed: monitoring failing on servers reporting unusual disk sizes

v1.1.1 · August 2026

A round of stability and polish fixes — no new features.

• Keys & credentials: RSA private key import completed — classic PKCS#1 supported and public keys derived from the private key for real; private keys are now always stored as OpenSSH PEM, fixing binary keys being corrupted by sync; new "re-push credentials to iCloud Keychain" in Settings for when another device is missing them; credentials carried over from older versions are normalised automatically
• Terminal: fixed terminals filling only a corner of the window after reconnecting (vim, htop and other full-screen programs); on iPhone and iPad you can now scroll back through history during continuous output such as tail -f; steadier Mosh-compatible connections — fixed stalls caused by out-of-order packets being discarded as replays, and spurious "link interrupted" warnings on a healthy link; Mosh-compatible sessions keep no scrollback (a protocol limitation), explained the first time you scroll up
• AI Agent: replies render as Markdown instead of raw ** and backticks; approval cards stay fully readable — long commands and rationales scroll inside the card, destructive commands get a "view full command" link; adding a follow-up task in the same conversation regenerates the plan
• iPhone UI: the terminal's top bar follows your terminal theme's light/dark, with the status bar and keyboard matching; SSH / Mosh-compatible badges on tabs are far easier to read
• Sync: fixed duplicate host rows reappearing after removal, via iCloud

v1.1.0 · August 2026

Our biggest update since launch: Mosh-compatible connections, third-party sync, and a refreshed UI across all three devices.

• Mosh-compatible connections: switch from Wi-Fi to 5G, ride an elevator, go through a tunnel — the session stays alive and picks up where it left off; typing stays smooth on slow, high-latency links. No mosh-server on the box? The connection test detects it and offers install instructions for your distro
• Third-party sync: sync hosts, keys, snippets, AI settings and chats across devices via your own WebDAV or S3-compatible storage — your data never touches anyone else's server; pair by scanning a QR code on iPhone (or picking the image from Photos) and importing it on Mac; Sync is now a top-level Settings section
• Navigation & UI: brand-new three-column layout on Mac / iPad; native tab bar on iPhone, with live terminal previews on session cards; files, monitor and AI slide in from the right inside a session; Mac gains a full native menu bar, shortcuts and window toolbar
• Snippets & terminal: new command toolbar above the terminal — run, insert or copy a snippet in one tap; snippet library redesigned with shell syntax highlighting, line numbers and review-before-run; tunnels can now be edited and deleted; ⌘K clears the terminal locally
• SFTP: downloads join the transfer queue with a choice of destination and more reliable resume; drag & drop upload on Mac; system notification when background transfers finish
• AI agent (bring your own key): custom command allow/deny lists, with one-tap "approve & allowlist"; sudo password prompts supported; the agent suspends on disconnect and resumes when you're back
• Stability: fixed a rare crash, credentials not reaching other devices over iCloud, a keychain edge case that could lose saved passwords, and iCloud sync being silently switched off; a strong warning when a host's key fingerprint changes

v1.0.5 · July 2026

Every improvement in this release comes from feedback by @break on V2EX — thank you.

• AI panel: message text is selectable, with a one-tap copy button on every reply
• AI panel: command output is shown in full — no more truncation
• AI panel: resizable width — drag the panel's left edge on Mac, the divider on iPad
• Terminal: new "Copy on Select", iTerm-style — selected text goes straight to the clipboard (Mac, Settings ▸ Terminal)
• AI panel: file-write diff previews can expand to show all changes
• Fixed: the host-fingerprint prompt could appear behind the New Host form or the Tunnels panel

Also shipping in this release:

• iPhone & iPad: fixed the garbled display when searching and scrolling in vim and other full-screen programs
• Mac: hold a letter key to repeat it — press-and-hold scrolls continuously in vim, less and friends
• Sturdier AI agent, SSH and terminal sessions; refreshed Mac app icon

v1.0.1 – v1.0.4 · July 2026

Quick fixes and polish during launch week.

v1.0.0 · July 2026

First release: SSH terminal, SFTP, port forwarding & tunnels, server monitoring, AI Agent, iCloud sync (macOS on Jul 7, iOS on Jul 13).

Android · Google Play (in review)

The first public release, v1.1.8, has been submitted to Google Play and this section will open the download once it clears review. The Android build shares its Flutter codebase with HarmonyOS and versions independently from the Apple edition. Can't wait? Join the closed beta now — steps below.

v1.1.8 · September 2026 · in review

The first public release. Thank you to everyone who stayed in the closed beta.

• SSH terminal: multiple sessions, colour themes, adjustable font size, reusable command snippets; a shortcut bar with sticky Alt and a \ key; Return and swipe-to-scroll work inside vim, tmux and other full-screen programs
• SFTP: browse remote directories, upload and download with resumable transfers
• Port forwarding: local / remote / dynamic SOCKS5 with multi-hop jump hosts, for reaching your own servers and internal services
• Server monitoring: CPU, memory, disk, load and processes at a glance
• Key management: generate or import keys and inspect fingerprints; credentials live in Android Keystore-backed encrypted storage
• App lock: optional biometric unlock, verified entirely on device
• Multi-device sync: opt-in, end-to-end encrypted through your own WebDAV or S3 storage — nothing passes through our servers; pairing codes can be scanned or picked from Photos, with an automatic fallback to picking an image when the camera is unavailable

Join the closed beta (takes a minute)

1. Join the tester group (one click, no approval needed): groups.google.com/g/shellbytestergroup
2. Open the opt-in link and accept the invite: play.google.com/apps/testing/me.mahui.mshell
3. Install from Google Play and use it as normal.

• The Google account you join the group with must be the same account signed in to the Play Store on your phone. Join with account A while your phone runs account B, and the opt-in page will keep saying you're not a tester.
• Membership doesn't take effect instantly. Syncing to Play can take from a few minutes to an hour or so; if the opt-in page says it isn't active yet, wait and try again.

Requirements: an Android phone or tablet (8.0+) with access to Google Play. Feedback goes to [email protected]; prefer to wait for the release? Leave your email on the homepage for a launch notice.

HarmonyOS NEXT

Live on Huawei AppGallery for phone and tablet: get it here. The HarmonyOS build shares its Flutter codebase with Android and versions independently from the Apple edition.

v1.1.8 · September 2026 · coming soon

Terminal compatibility fixes for full-screen programs. v1.1.6 is still the live build; this entry goes live once the update clears review (originally numbered 1.1.7, renumbered before submission together with the Android build it shares).

• Return works in full-screen programs: pressing Return did nothing inside vim, tmux and the like — the software keyboard's Return was sent as a plain line feed, which programs in raw mode do not accept as Enter
• Swipe to scroll in tmux: previously it did nothing even with mouse on enabled as documented
• Sticky Alt: tap Alt on the shortcut bar, then the next key is an Alt combo — word-wise cursor movement (Alt+B / Alt+F) and the last argument of the previous command (Alt+.) now work; a key was added too
• Fixed: tmux, vim and less occasionally spat stray characters onto the screen; viewing images with chafa or timg no longer floods the whole viewport
• Fixed: accented letters and emoji (skin-toned ones especially) shifted every table and box border a command-line program had drawn, from that character on
• Colour detection: command-line programs can now read the terminal's colours and cursor position correctly, so a light theme is no longer mistaken for a dark one
• Battery: going to the background is reported to the remote program, which pauses its animations and redraws

v1.1.6 · August 2026

A focused fix pass on port forwarding (tunnels).

• Tunnels recover on their own: the system suspends the app in the background and tunnels pause with it — they now reconnect when you return, instead of needing a manual stop and start
• Honest tunnel status: connecting / running / disconnected are shown separately, and the reason for a disconnect stays on the row — no more "running" that will not connect
• Rules grouped by host, with addresses and ports in a monospaced font so ownership and mapping read at a glance
• Fixed: editing a rule whose host had been deleted crashed the app; such rules are now labelled "host no longer exists" with the start button disabled
• Unfolded and split-screen layouts: noticeably more room for the terminal, with far less wrapping in command output
• Key fingerprints in a monospaced font, easier to verify against the server

v1.1.5 · August 2026

Polish pass following the first HarmonyOS release.

• Scan to import a pairing code — opens the system scanner; you can also pick a photo from the album inside it
• Fixed: recognising a pairing code from an image always failed
• Fixed: importing an SSH private key was rejected as "invalid format", and larger key files were truncated
• App icon rebuilt to the HarmonyOS layered-icon spec — no longer clipped on the home screen; no more white flash on cold start in dark mode
• Smaller install size

v1.1.4 · August 2026

The first HarmonyOS release.

• SSH terminal: multiple sessions, colour themes, adjustable font size, and reusable command snippets
• SFTP: browse remote directories, upload and download with resumable transfers
• Port forwarding: local / remote / dynamic SOCKS5 with multi-hop jump hosts, for reaching your own servers and internal services
• Server monitoring: CPU, memory, disk, load and processes at a glance
• Key management: generate or import keys and inspect fingerprints
• App lock: optional biometric unlock, verified entirely on device
• Multi-device sync: opt-in, end-to-end encrypted through your own WebDAV or S3 storage — nothing passes through our servers