WINRecommended for Windows
Windows portable
Choose this for most Windows PCs. Extract the zip and run wispterm.exe without an installer.
SHA25687acc3d429de43f57ff423298b545fb496978635a84bf593dadd6200fcb13b94
Download ZIPOPEN SOURCE · WINDOWS & MACOS
Latest release v1.33.1 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.33.1.dmgDOWNLOADS
Choose the package for your machine.
These are the current Windows and macOS assets from the v1.33.1 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.
SHA2568c17b1c678585d58393f5a4defd28e6edfd99d345b03755c88a8d0401bd2c225
Download ZIPD3DZIP
Windows native D3D11 portable
Choose this when the default graphics backend has compatibility trouble. It is still a portable ZIP for Windows machines that need the native D3D11 rendering path.
SHA256cca6f8b23572193eb9dff4c8a9c9c5a3a8496f6d1578b7500eeb5bf4b0dec991
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.
SHA25639d6da79e9c96e37dd56701087342cea414acb723d9295df747a30f097193f02
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.
SHA25627bc0dc67de514ca74779fcc6252243b651b62a59544feb3b121b64c7ec5d81f
Download DMGWHAT'S NEW
What changed in v1.33.1
The key additions and fixes from this release, summarized from the official GitHub release notes.
Added
- One Dark Pro themeAdded the built-in One Dark Pro color theme.
Fixed
- tmux clipboard workflow (#568)Shift-drag now selects terminal text while tmux mouse mode is enabled. Ctrl+Shift+V / Cmd+Shift+V keeps image paste behavior and falls back to text paste when the clipboard has no image.
- Markdown identifiersUnderscores inside identifiers such as wisp_science now render literally instead of being treated as emphasis.
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.33.1.
Which Windows package should I choose?
Start with Windows portable. Choose the compatibility package if the regular ZIP has trouble, or the Native D3D11 package for graphics-backend issues.
Are macOS packages signed?
The v1.33.1 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.