Release Notes
v0.13.1 — Dec 16, 2025
Windows Improvements and Wave AI Enhancements
This release focuses on significant Windows platform improvements, Wave AI visual updates, and better flexibility for local AI usage.
Windows Platform Enhancements:
- Integrated Window Layout - Removed separate title bar and menu bar on Windows, integrating controls directly into the tab-bar header for a cleaner, more unified interface
- Git Bash Auto-Detection - Wave now automatically detects Git Bash installations and adds them to the connection dropdown for easy access
- SSH Agent Fallback - Improved SSH agent support with automatic fallback to
\\.\pipe\openssh-ssh-agenton Windows - Updated Focus Keybinding - Wave AI focus key changed to Alt:0 on Windows for better consistency
- Config Schemas - Improved configuration validation and schema support
- Ctrl-V now works as standard paste in terminal on Windows
Wave AI Updates:
- Refreshed Visual Design - Complete UI refresh removing blue accents and adding transparency support for better integration with custom backgrounds
- BYOK Without Telemetry - Wave AI now works with bring-your-own-key and local models without requiring telemetry to be enabled
- [bugfix] Fixed tool type "function" compatibility with providers like Mistral
Terminal Improvements:
- New Scrolling Keybindings - Added Shift+Home, Shift+End, Shift+PageUp, and Shift+PageDown for better terminal navigation
Other Changes:
- Package updates and dependency upgrades
v0.13.0 — Dec 8, 2025
Wave v0.13 Brings Local AI Support, BYOK, and Unified Configuration
Wave v0.13 is a major release that opens up Wave AI to local models, third-party providers, and bring-your-own-key (BYOK) configurations. This release also includes a completely redesigned configuration system and several terminal improvements.
Local AI & BYOK Support:
- OpenAI-Compatible API - Wave now supports any provider or local server using the
/v1/chat/completionsendpoint, enabling use of Ollama, LM Studio, vLLM, OpenRouter, and countless other local and hosted models - Google Gemini Integration - Native support for Google's Gemini models with a dedicated API adapter
- Provider Presets - Simplified configuration with built-in presets for OpenAI, OpenRouter, Google, Azure, and custom endpoints
- Multiple AI Modes - Easily switch between different models and providers with a unified interface
- See the new Wave AI Modes documentation for configuration examples and setup guides
Unified Configuration Widget:
- New Config Interface - Replaced the basic JSON editor with a dedicated configuration widget accessible from the sidebar
- Better Organization - Browse and edit different configuration types (general settings, AI modes, secrets) with improved validation and error handling
- Integrated Secrets Management - Access Wave's secret store directly from the config widget for secure credential management
Terminal Improvements:
- Bracketed Paste Mode - Now enabled by default to improve multi-line paste behavior and compatibility with tools like Claude Code
- Windows Paste Fix - Ctrl+V now works as a standard paste accelerator on Windows
- SSH Password Management - Store SSH connection passwords in Wave's secret store to avoid re-typing credentials
Other Changes:
- Package updates and dependency upgrades
- Various bug fixes and stability improvements
v0.12.5 — Nov 24, 2025
Quick patch release to fix paste behavior on Linux (prevent raw HTML from getting pasted to the terminal).
v0.12.4 — Nov 21, 2025
Quick patch release with bug fixes and minor improvements.
- New
term:macoptionismetasetting for macOS to treat Option key as Meta key in terminal - Fixed directory tracking for zsh shells
- Fixed editor copy operations
- Minor Wave AI improvements (image handling, scrolling, focus)
- Package updates and dependency upgrades
- WIP: WaveApps builder framework (not yet released)
v0.12.3 — Nov 17, 2025
Patch release with Wave AI model upgrade, new secret management features, and improved terminal input handling.
Wave AI Updates:
- GPT-5.1 Model - Upgraded to use OpenAI's GPT-5.1 model for improved responses
- Thinking Mode Toggle - New dropdown to select between Quick, Balanced, and Deep thinking modes for optimal response quality vs speed
- [bugfix] Fixed path mismatch issue when restoring AI write file backups
New Features:
- Secret Store - New secret management widget for storing and managing sensitive credentials. Access secrets via CLI with
wsh secret list/get/setcommands
Terminal Improvements:
- Enhanced Input Handling - Better support for interactive CLI tools like Claude Code. Shift+Enter now inserts newlines by default for multi-line commands
- Image Paste Support - Paste images directly into terminal (saved to temp files with path inserted). Works great in Claude Code!
- IME Fix - Fixed duplicate text issue when switching input methods during Chinese/Japanese/Korean composition
Other Changes:
- Improved backend panic tracking for better debugging
- Fixed memory leak around sysinfo events
- WIP: New WaveApps builder framework (not yet released)
- Package updates and dependency bumps
v0.12.2 — Nov 4, 2025
Wave v0.12.2 adds file editing ability to Wave AI. Before approving a file edit you can easily see a diff (rendered in the Monaco Editor diff viewer), and after approving an edit you can easily roll back the change using a "Revert File" button.
Wave AI Updates:
- File Write Tool - Wave AI can now create and modify files with your approval
- Visual Diff Preview - See exactly what will change before approving edits, rendered in Monaco Editor
- Easy Rollback - Revert file changes with a simple "Revert File" button
- Drag & Drop Files - Drag files from the preview viewer directly to Wave AI
- Directory Listings -
wsh aican now attach directory listings to chats - Adjustable Settings - Control thinking level and max output tokens per chat
Bug Fixes & Improvements:
- Fixed a significant memory leak in the RPC system
- Schema validation working again for config files
- Improved tool descriptions and input validations (run before tool approvals)
- Fixed issue with premature tool timeouts
- Fixed regression with PowerShell 5.x
- Fixed prompt caching issue when attaching files
v0.12.1 — Oct 20, 2025
Patch release focused on shell integration improvements and Wave AI enhancements. This release fixes syntax highlighting in the code editor and adds significant shell context tracking capabilities.
Shell Integration & Context:
- OSC 7 Support - Added OSC 7 (current working directory) support across bash, zsh, fish, and pwsh shells. Wave now automatically tracks and restores your current directory across restarts for both local and remote terminals.
- Shell Context Tracking - Implemented shell integration for bash, zsh, and fish shells. Wave now tracks when your shell is ready to receive commands, the last command executed, and exit codes. This enhanced context enables better terminal management and lays the groundwork for Wave AI to write and execute commands intelligently.
Wave AI Improvements:
- Display reasoning summaries in the UI while waiting for AI responses
- Added enhanced terminal context - Wave AI now has access to shell state including current directory, command history, and exit codes
- Added feedback buttons (thumbs up/down) for AI responses to help improve the experience
- Added copy button to easily copy AI responses to clipboard
Other Changes:
- Mobile user agent emulation support for web widgets #2442
- [bugfix] Fixed padding for header buttons in code editor (Tailwind regression)
- [bugfix] Restored syntax highlighting in code editor preview blocks #2427
- Package updates and dependency bumps
v0.12.0 — Oct 16, 2025
Wave v0.12 Has Arrived with Wave AI (beta)!
Wave Terminal v0.12.0 introduces a completely redesigned AI experience powered by OpenAI GPT-5. This represents a major upgrade and modernization over Wave's previous AI integration, bringing multi-modal support, advanced tool integration, and an intuitive new interface. The main AI PR alone included 128 commits and added 13,000+ lines of code.
Wave AI Features:
- New Slide-Out Chat Panel - Access Wave AI via hotkeys (Cmd-Shift-A or Ctrl-Shift-0) from the left side of your screen
- Multi-Modal Input - Support for images, PDFs, and text file attachments
- Drag & Drop Files - Simply drag files into the chat to attach them
- Command-Line Integration - Send files and command output directly to Wave AI using
wsh ai - Smart Context Switching - Enable Wave AI to see into your widgets and file system
- Built-in Tools:
- Web search capabilities
- Local file and directory operations
- Widget screenshots
- Terminal scrollback access
- Web navigation
Wave AI is in active beta with included AI credits while we refine the experience. BYOK (Bring Your Own Key) will be available once we've stabilized core features and gathered feedback on what works best. Share your feedback in our Discord.
For more information and upcoming features, visit our Wave AI documentation.
Other Improvements:
- New onboarding flow showcasing block magnification, Wave AI, and wsh view/edit capabilities
- New
wsh blocks listcommand for listing and filtering blocks by workspace, tab, or view type - Continued migration from SCSS to Tailwind v4
- Package upgrades and dependency updates
- Internal code cleanup and refactoring
v0.11.6 — Sep 22, 2025
Patch release to address an editor bug when you open two files in separate edit widgets. Also adds Mermaid support to markdown blocks.
- WIP: Big AI overhaul coming (multi-modal support, premium models, and tool support)
- WIP: Integrating new Tsunami widget framework to make writing and running Wave widgets easier
- Lots of package updates
- Much internal cleanup (preview widget)
- More migration to Tailwind v4 CSS
- Build updates, switched to npm from yarn
v0.11.5 — Aug 28, 2025
Another housekeeping release to modernize Wave and bring it more up to date.
- Wave AI Cloud Proxy now uses gpt-5-mini (upgraded from gpt-4o-mini)
- Fixed JWT issue with running "Wave Apps" from widgets
- Added an "$ENV:envvar:fallback" syntax to the config files to allow Wave's config to pick up values from the environment (mostly to allow moving secrets out of the config files)
- New setting to disable showing overlay blocknums when holding Ctrl:Shift (
app:showoverlayblocknums) - New setting to allow Shift-Enter to work with tools like Claude Code (
term:shiftenternewline) - Upgraded frontend to React 19
- Migrated more of the frontend to Tailwind v4 (work in progress)
- Removed Universal MacOS build. 90% of Mac users are now on Apple Silicon, so universal build is less important (has a larger file size, and complicates the build process).
- [bugfix] Removed build-ids in RPM build to try to fix conflicts with Slack
- Removed some Wave v7 aware upgrades and old code paths
- Internal cleanup, TypeScript errors, linting fixes, etc.
- Other assorted Go/npm package bumps
v0.11.4 — Aug 19, 2025
Quick patch release to update packages, fix some security issues (with dependent packages), and some small bug fixes.
- Update AI Libraries, GPT-5 now supported in WaveAI
- Added
ai:proxyurlsetting to allow proxy access (e.g. SOCKS) for AI access
v0.11.3 — May 2, 2025
Quick patch release to update packages, fix some security issues (with dependent packages), and some small bug fixes.
v0.11.2 — March 8, 2025
Quick patch release to fix a backend panic, and revert a change that caused WSL connections to hang.
v0.11.1 — 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 filenow 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 --newadded to open the new ssh connection in a new widget- new
wsh launchcommand 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 — 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 aito 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 sshincreased 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 — 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 — Dec 19, 2024
Quick update to v0.10 with new features and bug fixes.
- Global hotkey support docs
- Added configuration to override the font size for markdown, AI-chat, and preview editor docs
- Added ability to set independent zoom level for the web view (right click block header)
- New
wsh wavepathcommand 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 — 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 — 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 runcommand for launching terminal commands in dedicated blocks, with support for magnification, auto-closing, and execution control (docs) - Connections: New configuration system for managing SSH connections, with support for wsh-free operation, per-connection themes, and more (docs)
- 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
-iflag to add identity files with thewsh sshcommand - Added Perplexity API integration (docs)
wsh setbgcommand for background handling (docs)- 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, AI Presets, and wsh overview.
- Other bug fixes, performance improvements, and dependency updates
v0.9.3 — 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/getvarto get and set variables -- Docswsh fileoperations (cat, write, append, rm, info, cp, and ls) -- Docs- 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 aifile 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
- MacOS 10.15 (Catalina) is no longer supported
- Other bug fixes, docs improvements, and dependency bumps
v0.9.2 — 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 and Presets work!
- Updated documentation
- Wave AI now supports the Anthropic API! Checkout the 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
-bparam inwsh. "tab:N" for accessing the nth tab, "[view]" and "[view]:N" for accessing blocks of a particlar view. - New
wsh aicommand 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