---
id: "releasenotes"
title: "Release Notes"
sidebar_position: 200
---

# Release Notes

### v0.11.3 &mdash; May 2, 2025

Quick patch release to update packages, fix some security issues (with dependent packages), and some small bug fixes.

### v0.11.2 &mdash; March 8, 2025

Quick patch release to fix a backend panic, and revert a change that caused WSL connections to hang.

### v0.11.1 &mdash; Feb 28, 2025

Wave Terminal v0.11.1 adds a lot of new functionality over v0.11.0 (it could have almost been a v0.12)!

The headline feature is our files/preview widget now supports browsing S3 buckets. We read credential information directly from your ~/.aws/config, and you can now easily select any of your AWS profiles in our connections drop down to start viewing S3 files. We even support editing S3 text files using our built-in editor.

Lots of other features and bug fixes as well:

- **S3 Bucket** directory viewing and file previews
- **Drag and Drop Files and Directories** between Wave directory views. This works across machines and between remote machines and S3 conections.
- Added json-schema support for some of our config files. You'll now get auto-complete popups for fields in our settings.json, widgets.json, ai.json, and connections.json file.
- New block splitting support -- Use Cmd-D and Cmd-Shift-D to split horizontally and vertically. For more control you can use Ctrl-Shift-S and then Up/Down/Left/Right to split in the given direction.
- Delete block (without removing it from the layout). You can use Ctrl-Shift-D to remove a block, while keeping it in the layout. you can then launch a new widget in its place.
- `wsh file` now supports copying files between your local machine, remote machines, and to/from S3
- New analytics framework (event based as opposed to counter based). See Telemetry Docs for more information.
- Web bookmarks! Edit in your bookmarks.json file, can open them in the web widget using Cmd+O
- Edits to your ai.json presets file will now take effect _immediately_ in AI widgets
- Much better error handling and messaging when errors occur in the preview or editor widget
- `wsh ssh --new` added to open the new ssh connection in a new widget
- new `wsh launch` command to open any custom widget defined in widget.json
- When using terminal multi-input (Ctrl-Shift-I), pasting text will now be sent to all terminals
- [bugfix] Fix some hanging goroutines when commands failed or timed out
- [bugfix] Fix some file extension mimetypes to enable the editor for more file types
- [bugfix] Hitting "tab" would sometimes scroll a widget off screen making it unusable
- [bugfix] XDG variables will no longer leak to terminal widgets
- Added tailwind CSS and shadcn support to help build new widgets faster
- Better internal widget abstractions

### v0.11.0 &mdash; Jan 24, 2025

Wave Terminal v0.11.0 includes a major rewrite of our connections infrastructure, with changes to both our backend and remote file protocol systems, alongside numerous features, bug fixes, and stability improvements.

A key addition in this release is the new shell initialization system, which enables customization of your shell environment across local and remote connections. You can now configure environment variables and shell-specific init scripts on both a per-block and per-connection basis.

For day-to-day use, we've added search functionality across both terminal and web blocks, along with a terminal multi-input feature for simultaneous input to all terminals within a tab. We've also added support for Google Gemini to Wave AI, expanding our suite of AI integrations.

Behind the scenes, we've redesigned our remote file protocol, laying the groundwork for upcoming S3 (and S3-compatible system) support in our preview widget. This architectural change sets the stage for adding more file backends in the future.

- **Shell Environment Customization** -- Configure your shell environment using environment variables and init scripts, with support for both local and remote connections
- **Connection Backend Improvements** -- Major rewrite with improved shell detection, better error logging, and reduced 2FA prompts when using ForceCommand
- **Multi-Shell Support** -- Enhanced support for bash, zsh, pwsh, and fish shells, with shell-specific initialization capabilities
- **Terminal Search** -- use Cmd-F to search for text in terminal widgets
- **Web Search** -- use Cmd-F to search for text in web views
- **Terminal Multi-Input** -- Use Ctrl-Shift-I to allow multi-input to all terminals in the same tab
- **Wave AI now supports Google Gemini**
- Improved WSL support with wsh-free connection options
- Added inline connection debugging information
- Fixed file permission handling issues on Windows systems
- Connection related popups are now delivered only to the initiating window
- Improved timeout handling for SSH connections which require 2FA prompts
- Fixed escape key handling in global event handlers (closing modals)
- Directory preview now fills the entire block width
- Custom widgets can now be launched in magnified mode
- Various workspace UX improvements around closing/deleting
- file:/// urls now work in web widget
- Increased max size of files allowed in `wsh ai` to 50k
- Increased maximum allowed term:scrollback to 50k lines
- Allow connections to entirely be defined in connections.json without relying on ~/.ssh/config
- Added an option to reveal files in external file viewer for local connection
- Added a New Window option when right clicking the MacOS dock icon button
- [build] Switched to free Ubuntu ARM runners for better ARM64 build support
- [build] Windows builds now use zig, simplifying Windows dev setup
- [bugfix] Connections dropdown now populated even when ssh config is missing or invalid
- [bugfix] Disabled bracketed paste mode by default (configuration option to turn it back on)
- [bugfix] Timeout for `wsh ssh` increased to 60s
- [bugfix] Fix for sysinfo widget when displaying a huge number of CPU graphs
- [bugfix] Fixes XDG variables for Snap installs
- [bugfix] Honor SSH IdentitiesOnly flag (useful when many keys are loaded into ssh-agent)
- [bugfix] Better shell environment variable setup when running local shells
- [bugfix] Fix preview for large text files
- [bugfix] Fix URLs in terminal (now clickable again)
- [bugfix] Windows URLs now work properly for Wave background images
- [bugfix] Connections launch without wsh if the unix domain socket can't be opened
- [bugfix] Connection status list lights up correctly with currently connected connections
- [bugfix] Use en_US.UTF-8 if the requested LANG is not available in your terminal
- Other bug fixes, performance improvements, and dependency updates

### v0.10.4 &mdash; Dec 20, 2024

Quick update with bug fixes and new configuration options

- Added "window:confirmclose" and "window:savelastwindow" configuration options
- [bugfix] Fixed broken scroll bar in the AI widget
- [bugfix] Fixed default path for wsh shell detection (used in remote connections)
- Dependency updates

### v0.10.3 &mdash; Dec 19, 2024

Quick update to v0.10 with new features and bug fixes.

- Global hotkey support [docs](https://docs.waveterm.dev/config#customizable-systemwide-global-hotkey)
- Added configuration to override the font size for markdown, AI-chat, and preview editor [docs](https://docs.waveterm.dev/config)
- Added ability to set independent zoom level for the web view (right click block header)
- New `wsh wavepath` command to open the config directory, data directory, and log file
- [bugfix] Fixed crash when /etc/sshd_config contained an unsupported Match directive (most common on Fedora)
- [bugfix] Workspaces are now more consistent across windows, closes associated window when Workspaces are deleted
- [bugfix] Fixed zsh on WSL
- [bugfix] Fixed long-standing bug around control sequences sometimes showing up in terminal output when switching tabs
- Lots of new examples in the docs for shell overrides, presets, widgets, and connections
- Other bug fixes and UI updates

(note, v0.10.2 and v0.10.3's release notes have been merged together)

### v0.10.1 &mdash; Dec 12, 2024

Quick update to fix the workspace app menu actions. Also fixes workspace switching to always open a new window when invoked from a non-workspace window. This reduces the chance of losing a non-workspace window's tabs accidentally.

### v0.10.0 &mdash; Dec 11, 2024

Wave Terminal v0.10.0 introduces workspaces, making it easier to manage multiple work environments. We've added powerful new command execution capabilities with `wsh run`, allowing you to launch and control commands in dedicated blocks. This release also brings significant improvements to SSH with a new connections configuration system for managing your remote environments.

- **Workspaces**: Organize your work into separate environments, each with their own tabs, layouts, and settings
- **Command Blocks**: New `wsh run` command for launching terminal commands in dedicated blocks, with support for magnification, auto-closing, and execution control ([docs](https://docs.waveterm.dev/wsh-reference#run))
- **Connections**: New configuration system for managing SSH connections, with support for wsh-free operation, per-connection themes, and more ([docs](https://docs.waveterm.dev/connections))
- Improved tab management with better switching behavior and context menus (many bug fixes)
- New tab features including pinned tabs and drag-and-drop improvements
- Create, rename, and delete files/directories directly in directory preview
- Attempt wsh-free connection as a fallback if wsh installation or execution fails
- New `-i` flag to add identity files with the `wsh ssh` command
- Added Perplexity API integration ([docs](https://docs.waveterm.dev/faq#perplexity))
- `wsh setbg` command for background handling ([docs](https://docs.waveterm.dev/wsh-reference#setbg))
- Switched from Less to SCSS for styling
- [bugfix] Fixed tab flickering issues during tab switches
- [bugfix] Corrected WaveAI text area resize behavior
- [bugfix] Fixed concurrent block controller start issues
- [bugfix] Fixed Preview Blocks for uninitialized connections
- [bugfix] Fixed unresponsive context menus
- [bugfix] Fixed connection errors in Help block
- Upgraded Go toolchain to 1.23.4
- Lots of new documentation, including new pages for [Getting Started](https://docs.waveterm.dev/gettingstarted), [AI Presets](https://docs.waveterm.dev/ai-presets), and [wsh overview](https://docs.waveterm.dev/wsh).
- Other bug fixes, performance improvements, and dependency updates

### v0.9.3 &mdash; Nov 20, 2024

New minor release that introduces Wave's connected computing extensions. We've introduced new `wsh` commands that allow you to store variables and files, and access them across terminal sessions (on both local and remote machines).

- `wsh setvar/getvar` to get and set variables -- [Docs](https://docs.waveterm.dev/wsh-reference#getvarsetvar)
- `wsh file` operations (cat, write, append, rm, info, cp, and ls) -- [Docs](https://docs.waveterm.dev/wsh-reference#file)
- Improved golang panic handling to prevent backend crashes
- Improved SSH config logging and fixes a reused connection bug
- Updated telemetry to track additional counters
- New configuration settings (under "window:magnifiedblock") to control magnified block margins and display
- New block/zone aliases (client, global, block, workspace, temp)
- `wsh ai` file attachments are now rendered with special handling in the AI block
- New ephemeral block type for creating modal widgets which will not disturb the underlying layout
- Editing the AI presets file from the Wave AI block now brings up an ephemeral editor
- Clicking outside of a magnified bglock will now un-magnify it
- New button to clear the AI chat (also bound to Cmd-L)
- New button to reset terminal commands in custom cmd widgets
- [bugfix] Presets directory was not loading correctly on Windows
- [bugfix] Magnified blocks were not showing correct on startup
- [bugfix] Window opacity and background color was not getting applied properly in all cases
- [bugfix] Fix terminal theming when applying global defaults [#1287](https://github.com/wavetermdev/waveterm/issues/1287)
- MacOS 10.15 (Catalina) is no longer supported
- Other bug fixes, docs improvements, and dependency bumps

### v0.9.2 &mdash; Nov 11, 2024

New minor release with bug fixes and new features! Fixed the bug around making Wave fullscreen (also affecting certain window managers like Hyprland). We've also put a lot of work into the doc site (https://docs.waveterm.dev), including documenting how [Widgets](./widgets) and [Presets](./presets) work!

- Updated documentation
- Wave AI now supports the Anthropic API! Checkout the [FAQ](./faq) for how to use the Claude models with Wave AI.
- Removed defaultwidgets.json and unified it to widgets.json. Makes it more straightforward to override the default widgets.
- New resolvers for `-b` param in `wsh`. "tab:N" for accessing the nth tab, "[view]" and "[view]:N" for accessing blocks of a particlar view.
- New `wsh ai` command to send AI chats (and files) directly to a new or existing AI block
- wsh setmeta/getmeta improvements. Allow setmeta to take a json file (and also read from stdin), also better output formats for getmeta (compatible with setmeta).
- [bugfix] Set max completion tokens in the OpenAI API so we can now work with o1 models (also fallback to non-streaming mode)
- [bugfix] Fixed content resizing when entering "full screen" mode. This bug also affected certain window managers (like Hyprland)
- Lots of other small bug fixes, docs updates, and dependency bumps

### v0.9.1 &mdash; Nov 1, 2024

Minor bug fix release to follow-up on the v0.9.0 build. Lots of issues fixed (especially for Windows).

- CLI applications that need microphone, camera, or location access will now work on MacOS. You'll see a security popup in Wave to allow/deny [#1086](https://github.com/wavetermdev/waveterm/issues/1086)
- Can now use `wsh version -v` to print out the new data/config directories
- Restores the old T1, T2, T3, ... tab naming logic
- Temporarily revert to using the "Title Bar" on windows to mitgate a bug where the window controls were overlaying on top of our tabs (working on a real fix for the next release)
- There is a new setting in the editor to enable/disable word wrapping [#1038](https://github.com/wavetermdev/waveterm/issues/1038)
- Ctrl-S will now save files in codeedit [#1081](https://github.com/wavetermdev/waveterm/issues/1081)
- [#1020](https://github.com/wavetermdev/waveterm/issues/1020) there is now a preset config option to change the active border color in tab themes
- [bugfix] Multiple fixes for [#1167](https://github.com/wavetermdev/waveterm/issues/1167) to try to address tab loss while updating
- [bugfix] Windows app crashed on opening View menu because of a bad accelerator key
- [bugfix] The auto-updater messages in the tab bar are now more consistent when switching tabs, and we don't show errors when the network is disconnected
- [bugfix] Full-screen mode now actually shows tabs in full screen
- [bugfix] [#1175](https://github.com/wavetermdev/waveterm/issues/1175) can now edit .awk files
- [bugfix] [#1066](https://github.com/wavetermdev/waveterm/issues/1066) applying a default theme now updates the background appropriately without a refresh

### v0.9.0 &mdash; Oct 28, 2024

New major Wave Terminal release! Wave tabs are now cached. Tab switching performance is
now much faster and webview state, editor state, and scroll positions are now persisted
across tab changes. We also have native WSL2 support. You can create native Wave connections
to your Windows WSL2 distributions using the connection button.

We've also laid the groundwork for some big features that will be released over the
next couple of weeks, including Workspaces, AI improvments, and custom widgets.

Lots of other smaller changes and bug fixes. See full list of PRs at https://github.com/wavetermdev/waveterm/releases/tag/v0.9.0

### v0.8.13 &mdash; Oct 24, 2024

- Wave is now available as a Snap for Linux users! You can find it [in the Snap Store](https://snapcraft.io/waveterm).
- Wave is now available via the Windows Package Manager! You can install it via `winget install CommandLine.Wave`
- can now use "term:fontsize" to override an individual terminal block's font size (also in context menu)
- we now allow mixed case hostnames for connections to be compatible with ssh config
- The Linux app icon is now updated to match the Windows icon
- [bugfix] fixed a bug that sometimes caused escape sequences to be printed when switching between tabs
- [bugfix] fixed an issue where the preview block was not cleaning up temp files (Windows only)
- [bugfix] fixed chrome sandbox permissions errors in linux
- [bugfix] fixed shutdown logic on MacOS/Linux which sometimes allowed orphaned processes to survive

### v0.8.12 &mdash; Oct 18, 2024

- Added support for multiple AI configurations! You can now run Open AI side-by-side with Ollama models. Can create AI presets in presets.json, and can easily switch between them using a new dropdown in the AI widget
- Fix WebSocket reconnection error. this sometimes caused the terminal to hang when waking up from sleep
- Added memory graphs, and per-CPU graphs to the sysinfo widget (and renamed it from cpuplot)
- Added a new huge red "Config Error" button when there are parse errors in the config JSON file
- Preview/CodeEdit widget now shows errors (squiggly lines) when JSON or YAML files fail to parse
- New app icon for Windows to better match Fluent UI standards
- Added copy-on-select to the terminal (on by default, can disable using "term:copyonselect")
- Added a button to mute audio in webviews
- Added a right-click "Open Clipboard URL" to easily open a webview from an URL stored in your system clipboard
- [bugfix] fixed blank "help" pages when waking from sleep or restarting the app

### v0.8.11 &mdash; Oct 10, 2024

Hotfix release to address a couple of bugs introduced in v0.8.10

- Fixes a regression in v0.8.10 which caused new tabs to sometimes come up blank and broken
- Layout fixes to the AI widget spacing
- Terminal scrollbar is now semi-transparent and overlays last column
- Fixes initial window size (on first startup) for both smaller and larger screens
- Added a "Don't Ask Again" checkbox for installing `wsh` on remote machines (sets a new config flag)
- Prevent the app from downgrading when you install a beta build. Installing a beta-build will now switch you to the beta-update channel.

### v0.8.10 &mdash; Oct 9, 2024

Minor big fix release (but there are some new features).

- added support for Azure AI [See FAQ](https://docs.waveterm.dev/faq#how-can-i-connect-to-azure-ai)
- AI errors now appear in the chat
- on MacOS, hitting "Space" in directorypreview will open selected file in Quick Look
- [bugfix] fixed transparency settings
- [bugfix] fixed issue with non-standard port numbers in connection dropdown
- [bugfix] fixed issue with embedded docsite (returned 404 after refresh)

### v0.8.9 &mdash; Oct 8, 2024

Lots of bug fixes and new features!

- New "help" view -- uses an embedded version of our doc site -- https://docs.waveterm.dev
- [breaking] wsh getmeta, wsh setmeta, and wsh deleteblock now take a blockid using a `-b` parameter instead of as a positional parameter
- allow metadata to override the block icon, header, and text (frame:title, frame:icon, and frame:text)
- home button on web widget to return to the homepage, option to set a homepage default for the whole app or just for the given block
- checkpoint the terminal less often to reduce frequency of output bug (still working on a full fix)
- new terminal themes -- Warm Yellow, and One Dark Pro
- we now support github flavored markdown alerts
- `wsh notify` command to send a desktop notification
- `wsh createblock` to create any block via the CLI
- right click to "Save Image" in webview
- `wsh edit` will now allow you to open new files (as long as the parent directly exists)
- added 8 new fun tab background presets (right click on any tab and select "Backgrounds" to try them out)
- [config] new config key "term:scrollback" to set the number of lines of scrollback for terminals. Use "-1" to set 0, max is 10000.
- [config] new config key "term:theme" to set the default terminal theme for all new terminals
- [config] new config key "preview:showhiddenfiles" to set the default "show hidden files" setting for preview
- [bugfix] fixed an formatting issue with `wsh getmeta`
- [bugfix] fix for startup issue on Linux when home directory is an NFS mount
- [bugfix] fix cursor color in terminal themes to work
- [bugfix] fix some double scrollbars when showing markdown content
- [bugfix] improved shutdown sequence to better capture wavesrv logs
- [bugfix] fix Alt+G keyboard accelerator for Linux/Windows
- other assorted bug fixes, cleanups, and security fixes

### v0.8.8 &mdash; Oct 1, 2024

Quick patch release to fix Windows/Linux "Alt" keybindings. Also brings a huge performance improvement to AI streaming speed.

### v0.8.7 &mdash; Sep 30, 2024

Quick patch release to fix bugs:

- Fixes windows SSH connections (invalid path while trying to install wsh tools)
- Fixes an issue resolving `~` in windows paths `~\` now works instead of just `~/`
- Tries to fix background color for webpages. Pulls meta tag for color-scheme, and sets a black background if dark detected (fixes issue rendering raw githubusercontent files)
- Fixed our useDimensions hook to fire correctly. Fixes some sizing issues including allowing error messages to show consistently when SSH connections fail.
- Allow "data:" urls in custom tab backgrounds
- All the alias "tab" for the current tab's UUID when using wsh
- [BUILD] conditional write generated files only if they are updated

### v0.8.6 &mdash; Sep 26, 2024

Another quick hotfix update. Fixes an issue where, if you deleted all of the tabs in a window, the window would be restored on next startup as completely blank.

Also, as a bonus, we added fish shell support!

### v0.8.5 &mdash; Sep 25, 2024

Hot fix, dowgrade `jotai` library. Upgrading caused a major regression in codeedit which did not allow
users to edit files.

### v0.8.4 &mdash; Sep 25, 2024

- Added a setting `window:disablehardwareacceleration` to disable native hardware acceleration
- New startup model for legacy users given them the option to download the WaveLegacy
- Use WAVETERM_HOME for the home directory consistently

### v0.8.3 &mdash; Sep 25, 2024

More hotfixes for Linux users. We now link against an older version of glibc and use
the zig compiler on linux (the newer version caused us not to run on older distros).  
Also fixes a permissions issue when installing via .deb. There is also a new config value
`window:nativetitlebar` which restores the native titlebar on windows/linux.

### v0.8.2 &mdash; Sep 24, 2024

Hot fix, fixes a nasty crash on startup for Linux users (dynamic linking but with netcgo DNS library)

### v0.8.1 &mdash; Sep 23, 2024

Minor cleanup release.

- fix number parsing for certain config file values
- add link to docs site
- add new back button for directory view
- telemetry fixes

### v0.8.0 &mdash; Sep 20, 2024

**Major New Release of Wave Terminal**

The new build is a fresh start, and a clean break from the current version. As such, your history, settings, and configuration will not be carried over. If you'd like to continue to run the legacy version, you will need to download it separately.

Release Artificats and source code diffs can be found on (Github)[https://github.com/wavetermdev/waveterm].
