This version introduces Mosh as an experimental feature. Choose Mosh under Persistence when editing a server to try it. Mosh is designed to keep the terminal connected as you move between Wi-Fi and cellular, through network dropouts and while your iPhone or iPad sleeps, and to show what you type right away on a slow connection. The server needs mosh-server and must accept UDP on ports 60000 to 61000, and ShellFish shows how to install mosh-server if it is missing. If Mosh gives you trouble, switch Persistence back to None or tmux, and feedback on what went wrong is very welcome. Images sent with the kitty graphics protocol now show in the terminal, from tools like kitten icat and yazi and from Claude Code mods that draw images. Run Install from Shell Integration on the server so Claude Code knows it can draw them. Images do not come through tmux or Mosh. Creating a security key such as a YubiKey, or signing in with one, now works on iOS 27. Fixes a new terminal sometimes being only a few rows tall when the keyboard bar is set to Always. Includes improvements from last version: ShellFish now supports iPhone Duo. On the wide inner display the terminal toolbar moves to a vertical strip beside the terminal with your tabs, the session picker and the server icon, and the keyboard bar spreads its keys across the wider keyboard. Partly folded like a laptop, the terminal takes the top half and is ready for typing. Suggest Command turns a plain-language description such as "make a compressed archive of src without the log files" into a shell command, using Apple's Private Cloud Compute model. Long-press the paste button on the keyboard bar or press Cmd-I. The model reads the manual pages on the server you are connected to, so it suggests options that exist there, and the command is only inserted at the prompt when you choose Insert. Requires the latest version of iOS with Apple Intelligence enabled. Shortcuts actions no longer have to finish within a few seconds. On the latest version of iOS an upload, a download or the listing of a large folder keeps running in the background for as long as it needs, showing how far it has come and offering a stop button if you want to end it early. A new Control Cloud Server action creates, starts, stops, checks and destroys cloud servers. You pick the region, the plan and the system image the same way you do in the app, and a server that takes minutes to come up reports what it is doing while you wait. The server it gives you back drops straight into the next action, even before you have saved it as a server of your own. A new Run Command action then runs a command on that server, or on any saved server, without opening the app. Output appears line by line while the command works and the full output is handed back to the rest of your shortcut, so a single shortcut can bring up a server, run a build or a backup on it that takes minutes, and shut it down again.

ShellFish now supports iPhone Duo. On the wide inner display the terminal toolbar moves to a vertical strip beside the terminal with your tabs, the session picker and the server icon, and the keyboard bar spreads its keys across the wider keyboard. Partly folded like a laptop, the terminal takes the top half and is ready for typing. Small layout improvements in terminal settings. Improvements to OpenCode integration. Fixes a crash on iOS 18 where the app could run out of memory as soon as a terminal opened. Includes improvements from last version: Suggest Command turns a plain-language description such as "make a compressed archive of src without the log files" into a shell command, using Apple's Private Cloud Compute model. Long-press the paste button on the keyboard bar or press Cmd-I. The model reads the manual pages on the server you are connected to, so it suggests options that exist there, and the command is only inserted at the prompt when you choose Insert. Requires the latest version of iOS with Apple Intelligence enabled. Shortcuts actions no longer have to finish within a few seconds. On the latest version of iOS an upload, a download or the listing of a large folder keeps running in the background for as long as it needs, showing how far it has come and offering a stop button if you want to end it early. A new Control Cloud Server action creates, starts, stops, checks and destroys cloud servers. You pick the region, the plan and the system image the same way you do in the app, and a server that takes minutes to come up reports what it is doing while you wait. The server it gives you back drops straight into the next action, even before you have saved it as a server of your own. A new Run Command action then runs a command on that server, or on any saved server, without opening the app. Output appears line by line while the command works and the full output is handed back to the rest of your shortcut, so a single shortcut can bring up a server, run a build or a backup on it that takes minutes, and shut it down again.

Swipe the keyboard bar sideways for word suggestions that better predict what you want to type and can insert two words with one tap. Fixes an issue in tmux where the last line of output and the prompt after it sometimes did not appear until you pressed a key. Apps that ask the terminal for its window and character size now get the real sizes, which helps inline images and tools such as tmux. Includes improvements from last version: Suggest Command turns a plain-language description such as "make a compressed archive of src without the log files" into a shell command, using Apple's Private Cloud Compute model. Long-press the paste button on the keyboard bar or press Cmd-I. The model reads the manual pages on the server you are connected to, so it suggests options that exist there, and the command is only inserted at the prompt when you choose Insert. Requires the latest version of iOS with Apple Intelligence enabled. Shortcuts actions no longer have to finish within a few seconds. On the latest version of iOS an upload, a download or the listing of a large folder keeps running in the background for as long as it needs, showing how far it has come and offering a stop button if you want to end it early. A new Control Cloud Server action creates, starts, stops, checks and destroys cloud servers. You pick the region, the plan and the system image the same way you do in the app, and a server that takes minutes to come up reports what it is doing while you wait. The server it gives you back drops straight into the next action, even before you have saved it as a server of your own. A new Run Command action then runs a command on that server, or on any saved server, without opening the app. Output appears line by line while the command works and the full output is handed back to the rest of your shortcut, so a single shortcut can bring up a server, run a build or a backup on it that takes minutes, and shut it down again.

Adjustments to how the terminal size is calculated to fix a case where the top of the terminal was hidden. Snippet that sends ^J no longer acts as Return. Snippets made before this build need the ^J entered again. Customized keys on the Fn row would sometimes send their keycap text (such as ^A instead of an actual Control-A). This is fixed, but you need to customize the key again for the fix to take effect. Includes improvements from last update: Suggest Command turns a plain-language description such as "make a compressed archive of src without the log files" into a shell command, using Apple's Private Cloud Compute model. Long-press the paste button on the keyboard bar or press Cmd-I. The model reads the manual pages on the server you are connected to, so it suggests options that exist there, and the command is only inserted at the prompt when you choose Insert. Requires the latest version of iOS with Apple Intelligence enabled. Shortcuts actions no longer have to finish within a few seconds. On the latest version of iOS an upload, a download or the listing of a large folder keeps running in the background for as long as it needs, showing how far it has come and offering a stop button if you want to end it early. A new Control Cloud Server action creates, starts, stops, checks and destroys cloud servers. You pick the region, the plan and the system image the same way you do in the app, and a server that takes minutes to come up reports what it is doing while you wait. The server it gives you back drops straight into the next action, even before you have saved it as a server of your own. A new Run Command action then runs a command on that server, or on any saved server, without opening the app. Output appears line by line while the command works and the full output is handed back to the rest of your shortcut, so a single shortcut can bring up a server, run a build or a backup on it that takes minutes, and shut it down again. Inside tmux, lines that had been cleared could stay on screen, so a prompt appeared twice or clear left the old screen in place. The flicker reduction behind this has been undone until it is sorted out.

Suggest Command turns a plain-language description such as "make a compressed archive of src without the log files" into a shell command, using Apple's Private Cloud Compute model. Long-press the paste button on the keyboard bar or press Cmd-I. The model reads the manual pages on the server you are connected to, so it suggests options that exist there, and the command is only inserted at the prompt when you choose Insert. Requires the latest version of iOS with Apple Intelligence enabled. Shortcuts actions no longer have to finish within a few seconds. On the latest version of iOS an upload, a download or the listing of a large folder keeps running in the background for as long as it needs, showing how far it has come and offering a stop button if you want to end it early. A new Control Cloud Server action creates, starts, stops, checks and destroys cloud servers. You pick the region, the plan and the system image the same way you do in the app, and a server that takes minutes to come up reports what it is doing while you wait. The server it gives you back drops straight into the next action, even before you have saved it as a server of your own. A new Run Command action then runs a command on that server, or on any saved server, without opening the app. Output appears line by line while the command works and the full output is handed back to the rest of your shortcut, so a single shortcut can bring up a server, run a build or a backup on it that takes minutes, and shut it down again. Inside tmux, lines that had been cleared could stay on screen, so a prompt appeared twice or clear left the old screen in place. The flicker reduction behind this has been undone until it is sorted out.

Server icon can now be a picture of your own. The icon in server settings opens a menu where you pick one of the drawn styles, choose an image file or edit the initials, which can also be emoji. A chosen image syncs to your other devices through iCloud and is used in the Files app as well. A tunnel can be configured for use only when needed. The button next to the tunnel in server settings lets you pick Always or As needed, where the server is reached directly when possible and the tunnel is only used when that fails, so a server on your local network no longer needs a second entry for when the tunnel host is out of reach. Terminal apps can ask which colors the terminal draws with to determine whether they are running in light or dark mode. Much less flickering from terminal apps that redraw their screen many times a second. The brief moment where such an app has erased its display but not yet repainted it no longer reaches the screen. Pressing Esc followed quickly by another key in Neovim is no longer mistaken for holding Alt with that key, which could move lines around in the editor. The terminal now supports the Kitty keyboard protocol that editors ask for when starting, so Esc reaches the server in a form that cannot blur together with the next keystroke. Improved text rendering when typing Korean, which previously added extra spacing around characters. Terminal apps that support the mouse can receive a real right-click or a click and drag. Hold Option while you click or drag with a mouse or trackpad, and the press, movement and release reach the app as they happen, so a menu like tmux's stays open long enough to use and you can drag to select.

Improvements to pasting into the terminal, which now explains itself instead of silently doing nothing when something goes wrong. Improvements to tmux native mode. Assigning a function or navigation key to a customizable key now sends that key. Picking something like Navigation keys > Page Up stored the keycap instead of the key behind it, so pressing it typed the words on the cap rather than moving through the screen. Keys you assigned this way before this build keep the old behaviour until you pick them again.

Collapsed server groups show a count of the servers inside. Starting a session works again on tmux 3.2 and older, along with general improvements to tmux native mode. Improved support for DEC 2026 to avoid terminal flicker. Holding alt while tapping/clicking sends the click through to mouse-aware programs (tmux, Midnight Commander), including trackpad/mouse right-clicks; shift keeps the tap local for cursor placement and selection. Esc, ctrl and alt on the keyboard bar can be customized with tap-and-hold.

The server list now has a selection mode. Start it from the (...) button to pick multiple servers, then move the whole selection to a group, delete it, export it, or open a new terminal that runs a shared command across every selected server. You can now generate and import SSH keys directly from the pop-up menu used to pick an SSH key for a server. Keyboard Shortcut Change The Type Sentence shortcut is now Command-Shift-E (previously Command-E).

Fixed a bug from a recent update where an already-authenticated connection would wait for re-authentication, causing delays with tmux or would refuse to attempt authentication for some server configurations. The keyboard bar now has a three-way visibility setting: Never, Automatically, or Always, remembered separately for the on-screen and external keyboards. The Always setting keeps the bar on screen for the whole session, even when the terminal is not focused. Export servers as a CSV file from the (...) button above the server list. New 'settitle' shell command sets the terminal, tab, and window title and works in bash, zsh, and fish. An empty argument restores the default title. This requires updating the Shell Integration. Fixed a crash when a port forward was configured with a port number above 65535.

The keyboard bar now has a three-way visibility setting: Never, Automatically, or Always, remembered separately for the on-screen and external keyboards. The Always setting keeps the bar on screen for the whole session, even when the terminal is not focused. Export servers as a CSV file from the (...) button above the server list. Fixed a bug from a recent update where an already-authenticated connection would wait for re-authentication, causing delays with tmux. New 'settitle' shell command sets the terminal, tab, and window title and works in bash, zsh, and fish. An empty argument restores the default title. This requires updating the Shell Integration. Fixed a crash when a port forward was configured with a port number above 65535.

New 'download' shell command that saves a file from the server to anywhere in Files app. This requires updating the Shell Integration. On iPad, the manual page viewer can be docked to the left or right of the terminal instead of floating, so a man page stays open beside a live session. A button in its navigation bar switches between Floating, Left Side and Right Side, and your choice is remembered. Browser re-authentication works with any server that withholds login behind a browser link, not just Tailscale. When a login banner carries an informational link it is surfaced in the connection status and stays tappable. Images pasted into the terminal upload with a generated name like pasted-from-shellfish-20260701-143012.png Fix for pinyin and other multistage input methods where picking a candidate could delete the typed letters instead of sending the composed text.

Support for Tailscale SSH check mode. When a host enforces periodic re-authentication, ShellFish opens the Tailscale login in a browser and connects once you authenticate. The Hostkey fingerprints list gains a per-row Copy action. Improvements to LLM agent hooks to correctly show notifications. This requires reinstalling Shell Integration. The Manage screen's Discard changes and Remove cache actions now sit in a (...) button instead of being hidden behind a long-press menu.

New manual page viewer. Select a command in the terminal and choose Manual to read its man page without leaving the app, or browse all of a server's manual pages from the View menu. Pages are downloaded and rendered on device, so they are searchable and selectable, with a section navigator and tappable cross references like fork(2) that jump to the referenced page. Fixed the paste button in the keyboard bar sometimes appearing blank. As a result, iOS may now prompt you when pasting from other apps. You can turn these prompts off under Settings → ShellFish → Paste from Other Apps → Allow. Type Sentence mode no longer ends when you press enter. You can still toggle from the paste button's context menu. Open Terminal action now works correctly on iPhone. When creating Digital Ocean droplets, plans are now correctly sorted by price. Improved importing of iTerm2 terminal themes.

Fixes incorrect cursor placement. Includes updates from previous update: Tap "Scan clipboard" when configuring a new server to pull connection details out of a screenshot or text. Processing happens entirely on device making it exclusive to newer iPads, iPhones & Macs.

Tap "Scan clipboard" when configuring a new server to pull connection details out of a screenshot or text. Processing happens entirely on device making it exclusive to newer iPads, iPhones & Macs. Fixes for keyboard customization and Keyboard Presets. Allow auto-scrolling terminal to extend selection. Improvements to tmux native mode. Fixes incorrect cursor placement.

Tap "Scan clipboard" when configuring a new server to pull connection details out of a screenshot or text. Processing happens entirely on device making it exclusive to newer iPads, iPhones & Macs. Fixes for keyboard customization and Keyboard Presets. Allow auto-scrolling terminal to extend selection. Improvements to tmux native mode.

It is now possible to customize buttons on the Fn keyboard. All keyboard bar + Fn customizations are stored in presets that you can switch between by long-pressing the Fn key. Presets can be managed in Settings > Keyboard Presets, where you can also export and import them to share with others. Enable a new tmux native mode with regular scrolling and no tmux bar in Settings > Advanced or from the context menu of the session picker button. Shell Integration install looks for Claude Code, Codex CLI or OpenCode installations and asks to install hooks to use notifications or Live Activity for questions from agent. Improved the logic that determines when a terminal should receive keyboard focus after returning to it. Fixed an issue where the current directory was not communicated correctly from the shell to the app on some servers, which could cause Drag-and-Drop or Paste uploads to fail. This fix requires reinstalling Shell Integration. Nicer tmux session picker. Improvements to Files app location.

It is now possible to customize buttons on the Fn keyboard. All keyboard bar + Fn customizations are stored in presets that you can switch between by long-pressing the Fn key. Presets can be managed in Settings > Keyboard Presets, where you can also export and import them to share with others. Enable a new tmux native mode with regular scrolling and no tmux bar in Settings > Advanced or from the context menu of the session picker button. Shell Integration install looks for Claude Code, Codex CLI or OpenCode installations and asks to install hooks to use notifications or Live Activity for questions from agent. Improved the logic that determines when a terminal should receive keyboard focus after returning to it. Fixed an issue where the current directory was not communicated correctly from the shell to the app on some servers, which could cause Drag-and-Drop or Paste uploads to fail. This fix requires reinstalling Shell Integration. Nicer tmux session picker. Fixed an issue where the Files app failed to download files whose names contain diacritics due to Unicode normalization differences between the server and ShellFish.

Selecting text in the terminal is now easier, with clearer selection highlighting when the server accepts mouse events. Fixed a recently introduced bug that broke uploads from the share sheet. When pasting images and files into the terminal, there is now an option to insert the path of the uploaded file. More robust NFC/NFD Unicode normalization in Files app. Fixes issue where opening tmux session as new tab from session picker blocked text input.

Improvements to port forwarding showing duration + amount transferred in Settings and avoiding automatically starting a port forward alongside terminal when already using the same local or remote port. Window > Move Tab to New Window menu action on iPad.

Password insertion change from last update has been reverted as it was still essential for some users. Fixes crash that could happen when showing tmux session picker.

Improved how right-to-left text is rendered in terminal. Password insertion from paste button is simplified to show biometrics and then confirm. Useful control combinations added to snippet gallery and put as defaults on right keyboard bar. Remember that you can customize these button assignments by long-tapping them.

ShellFish has supported YubiKeys over NFC for a while, and now USB keys work too. Generate, export, and import them like any other keys - they just require the physical key to authenticate. Due to sandboxing restrictions, USB YubiKeys are accessed from a browser context, so your server needs to support webauthn-sk-ecdsa and the key application field must be localhost rather than ssh: The context menu when starting terminals from the server list now has a submenu for picking an existing tmux session or creating a new one, instead of always connecting to the default. On iPad, hover the pointer over the session picker for a thumbnail popup.

Shift + Return works like Alt + Return to add newline without submitting prompt in Claude Code. Improvements to Live Activity such that it correctly dismisses when terminal closes. Control+Backspace will send ascii 8. Improvements when using floating on-screen keyboard. Fixes to Multipath TCP network mode.