WINRecommended for Windows
Windows portable
Choose this for most Windows PCs. Extract the zip and run wispterm.exe without an installer.
SHA256612baf268a8abda1d42137db28ef4f76ecfa088e382206e8450c43ccbf008340
Download ZIPOPEN SOURCE · WINDOWS & MACOS
Latest release v1.34.0 is availableWispTermTerminal, remote files, and AI—one workspace.
WispTerm brings SSH, split panes, file browsing and previews, and agent sessions into one open-source desktop app—so you can switch windows less and stay focused on the work.
01libghostty-vtterminal core02Zignative runtime03AI tabsexportable sessions
SMART DOWNLOAD
The right build, selected for you.
We detect Windows or macOS and surface the most common package first. When a Mac CPU cannot be identified reliably, Apple Silicon is the default recommendation.
Detecting this device…
Recommended for your device
macOS Apple Silicon
For Apple silicon Macs including M1, M2, M3, and M4. Requires macOS 13 or newer.
wispterm-macos-aarch64-v1.34.0.dmgDOWNLOADS
Choose the package for your machine.
These are the current Windows and macOS assets from the v1.34.0 GitHub release. Checksums are shown inline so the file you download can be verified.
Quick recommendationMac M-series: Apple Silicon DMG. Intel Mac: Intel DMG. Windows: regular portable ZIP first; use the other ZIPs only for compatibility or graphics-backend issues.
CMPCompatibility ZIP
Windows portable compat
Choose this if the regular ZIP has compatibility trouble. It is still portable and intended as the fallback Windows build.
SHA2561c7ac5b7c7924d18c8269a193d3527a73b4dbb9ce53ded38d4318002ac7a4773
Download ZIPGPUZIP
Windows graphics fallback portable
Choose this when the default graphics backend does not work correctly. It is still a portable ZIP that uses an alternative rendering backend.
SHA256816e6d7d4431d118e77845b173ef5ad8a4deb950c040fd3228ecacc120985a73
Download ZIPARMM-series Mac
macOS Apple Silicon
Choose this for Mac with M1, M2, M3, or M4 chips. Requires macOS 13 or newer; the DMG is signed and notarized by Apple.
SHA256a6c7fbe5b10f97d636bdccec8dc300abc8f87399becaa617a4c1505a91ee1d8a
Download DMGINTIntel Mac
macOS Intel
Choose this only for Intel-based Macs. Requires macOS 13 or newer; check About This Mac if you are unsure.
SHA256e82adeecfdaf393d33a5e30026dbef2db8ccfdf270b650227c3e350a994b760c
Download DMGWHAT'S NEW
What changed in v1.34.0
The key additions and fixes from this release, summarized from the official GitHub release notes.
Changed
- Native D3D11 is now the Windows defaultThe normal portable and compat packages use the native Direct3D 11 renderer. OpenGL remains available as the separate wispterm-windows-portable-opengl-*.zip fallback and keeps following OpenGL assets during in-app updates.
- Visual settings and shell defaults (#573)Improved the Settings visual controls and made new-session shell defaults clearer and more consistent.
Fixed
- SSH terminal identity (#579)SSH sessions no longer spoof Ghostty through TERM_PROGRAM, avoiding provider-specific failures such as Grok CLI rejecting WispTerm as an unsupported terminal.
- Architecture-aware updates (#575)macOS now selects the release DMG that matches the running Apple Silicon or Intel architecture.
- Linux AppImage updates (#577)Linux now matches the published x86_64 AppImage asset name correctly.
- Clipboard documentation (#576, #578)English and Chinese documentation now agree on tmux selection, image paste, and text-paste fallback behavior.
Tooling
- wisptermctlwisptermctl-<version>.zip: all desktop builds in one archive (Linux x86_64/aarch64, macOS Intel/Apple Silicon, Windows x86_64). Extract it and pick the binary for your platform — see the bundled README.txt. Enable the API in WispTerm with agent-control-enabled = true, restart, then run wisptermctl panes.
LEARNING CENTER
Watch the whole workflow, then try it at your own pace.
Start with the full video walkthrough, then browse focused guides and product notes when you need them.
Browse all guides →
Featured video guideWS / GUIDE / 01
AI4S: Using WispTerm as a research workspace
A 43-minute Chinese-language walkthrough by Zhougeng Xu, moving from practical AI framing to command-line research workflows with WispTerm.Open this guide →TERMINAL WORKSPACE
A Ghostty-powered terminal with the panes daily work needs.
WispTerm pairs terminal emulation with practical surrounding panels, so remote sessions, file context, previews, and AI coding work stay anchored to the command line.
Ghostty terminal core
Uses libghostty-vt for VT parsing and terminal state, with native font discovery and per-glyph fallback.
Split panes and tabs
Arrange vertical and horizontal splits, tab strips, focus-follows-mouse, spatial focus movement, and equalized pane sizes.
Files beside the terminal
Browse local and SSH files, then preview Markdown, text, CSV, TSV, and images without opening another app.
Agent sessions
Run OpenAI-compatible agent tabs with shell context, tool approvals, restored history, and clean Markdown export.
WORK MODES
Designed for terminal-heavy workdays.
File inspection, AI agent control, theming, browser previews, and rendering details share the same calm workspace.
Remote file context
Keep local and SSH file navigation adjacent to the active terminal, with previews one pane away.
Agent control
Keep agent conversations tied to the shell, preserve approvals, restore history, and export records.
Themes and texture
Start from 453 built-in themes, add background images, and tune the terminal with shader effects.
CORE FEATURES
A focused set for modern terminal work.
WispTerm centers on the details that matter when the terminal is the main workspace, not a detached side tool.
libghostty-vt core
Ghostty-compatible terminal emulation for VT parsing and terminal state.
Native font rendering
DirectWrite discovery, FreeType rasterization, per-glyph fallback, and crisp terminal symbols.
Splits and tabs
Pane splits, tab sidebar, focus-follows-mouse, and equalized sizing.
File explorer
Preview Markdown, text, CSV, TSV, and images without leaving the terminal.
Agent tabs
Keep AI agent sessions beside the shell with approvals, history, and Markdown export.
453 themes
Use built-in Ghostty-compatible themes, including Poimandres as the default.
Background images
Add PNG, JPG, BMP, GIF, or TGA backgrounds with terminal-aware opacity blending.
Embedded browser panel
Open web URLs in a side panel on Windows, with SSH loopback forwarding for profile sessions.
Kitty graphics
Display inline images and PDFs from remote shells with helper scripts.
Hot-reload config
Open the config file from the app and apply changes on save without restarting.
Custom shaders
Apply Ghostty-compatible GLSL post-processing when you want a more tuned terminal surface.
Sprite rendering
Render box drawing, block, braille, and powerline glyphs as crisp terminal sprites.
FAQ
Questions before downloading.
Short answers for choosing and verifying the release packages.
Where do the download buttons point?
Every package link points to the xuzhougeng/wispterm GitHub Releases download URL for v1.34.0.
Which Windows package should I choose?
Start with Windows portable. Choose the compatibility package if the regular ZIP has trouble, or the graphics fallback package for rendering issues.
Are macOS packages signed?
The v1.34.0 release notes state that the macOS DMGs are signed with a Developer ID Application certificate and notarized by Apple. The macOS packages require macOS 13 or newer.
How is WispTerm configured?
WispTerm uses a Ghostty-style key-value config file. Open it from the app, save changes, and the running workspace applies them without a restart.
What can the file preview panel open?
The preview panel is built for daily terminal-adjacent files: Markdown, plain text, CSV, TSV, and common image formats.
Where is the source code?
The source is available on GitHub under the xuzhougeng/wispterm repository.