Wave Terminal: The Open-Source Terminal for Integrated Development
Wave Terminal is an innovative open-source terminal that merges traditional command-line functionality with advanced graphical capabilities, including file previews, web browsing, and AI assistance. It streamlines development workflows on MacOS, Linux, and Windows by minimizing context switching and providing powerful, CLI-driven visual tools.

Wave Terminal is an open-source solution that seamlessly blends traditional terminal features with robust graphical capabilities. Designed to run across MacOS, Linux, and Windows, it offers integrated file previews, web browsing, and AI assistance directly within your command-line environment.
Modern development often requires frequent context switching between terminals and web browsers for documentation, file previews, system monitoring, and AI tool usage. Wave addresses this by integrating these graphical tools directly into the terminal, allowing you to control them efficiently from the command line. This approach enables developers to maintain their terminal-centric workflow while still accessing essential visual interfaces.

Key Features
- Flexible Interface: A drag-and-drop system for organizing terminal blocks, editors, web browsers, and AI assistants.
- Built-in Editor: Seamlessly edit remote files with syntax highlighting and modern editor functionalities.
- Rich File Preview System: Comprehensive previews for various remote file types, including Markdown, images, video, PDFs, CSVs, and directories.
- Quick Full-Screen Toggle: Instantly expand any block—terminals, editors, or previews—for enhanced visibility, then return to a multi-block view with ease.
- Wave AI: A context-aware terminal assistant that can read terminal output, analyze widgets, and perform file operations.
- AI Chat Widget: Supports multiple AI models, including OpenAI, Claude, Azure, Perplexity, and Ollama.
- Command Blocks: Isolate and monitor individual commands, with options for auto-closure.
- One-Click Remote Connections: Provides full terminal and file system access to remote hosts.
- Secure Secret Storage: Utilizes native system backends to securely store API keys and credentials locally, accessible across SSH sessions.
- Rich Customization: Offers extensive personalization options, including tab themes, terminal styles, and background images.
- Powerful
wshCommand System: Manage your workspace from the command-line interface (CLI) and facilitate data sharing between terminal sessions. - Connected File Management: Use
wsh filefor seamless copying and syncing of files between local systems, remote SSH hosts, Wave's filesystem, and S3 buckets.
Wave AI
Wave AI functions as a context-aware terminal assistant, offering integrated access to your workspace:
- Terminal Context: Reads terminal output and scrollback history for debugging and analysis.
- File Operations: Capable of reading, writing, and editing files, complete with automatic backups and user approval.
- CLI Integration: Utilizes
wsh aito pipe output or attach files directly from the command line. - Free Beta: Includes AI credits while the experience is being refined.
- Coming Soon: Anticipated features include command execution (with approval), local model support, and integration with alternate AI providers (Bring Your Own Key).
Installation
Wave Terminal is compatible with macOS, Linux, and Windows.
Detailed platform-specific installation instructions are available. You can also download Wave Terminal directly from www.waveterm.dev/download.
Minimum Requirements
Wave Terminal runs on:
- macOS 11 or later (arm64, x64)
- Windows 10 1809 or later (x64)
- Linux based on glibc-2.28 or later (e.g., Debian 10, RHEL 8, Ubuntu 20.04) (arm64, x64)
The WSH helper runs on:
- macOS 11 or later (arm64, x64)
- Windows 10 or later (arm64, x64)
- Linux Kernel 2.6.32 or later (x64), Linux Kernel 3.1 or later (arm64)
Roadmap & Community
Wave is continuously evolving, and its roadmap is regularly updated to reflect ongoing goals for each release. The development team actively seeks community input for future releases, encouraging users to connect on platforms like Discord or submit feature requests.
License
Wave Terminal is licensed under the Apache-2.0 License. Information regarding its dependencies is available.