WINRecommended for Windows
Windows portable
Choose this for most Windows PCs. Extract the zip and run wispterm.exe without an installer.
SHA256646b24916f2e81e6693994568a51fe9e3b396fc432e844c7a2c00bdf49883ae9
Download ZIPOPEN SOURCE · WINDOWS & MACOS
Latest release v1.40.5 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.40.5.dmgDOWNLOADS
Choose the package for your machine.
These are the current Windows and macOS assets from the v1.40.5 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.
SHA25631e2fd861d706bca490984a4fd1f9e14957406c2af0ac9f591435bcbc42c4f76
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.
SHA256e05c6b33d2c4a961704123d19c05862aea495ad5e93c42276f03be65e5833c33
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.
SHA2569e3ef03f2552c4bbb4b583b4cce8fda119443f2bd88f5de134dfb173833992f2
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.
SHA256c24f0c4d51160110b76380054f173990579043f0d177b2feb6ba5b60aa5759d2
Download DMGWHAT'S NEW
What changed in v1.40.5
The key additions and fixes from this release, summarized from the official GitHub release notes.
Added
- Scoped workbench shortcutsFile Explorer, Agent History, AI History, Memory Center, Conversation Center, Port Forwarding, and Skill Center shortcuts are keybind entries. A scope keeps the same key available on different pages, for example keybind = file-explorer:r=file_explorer_rename and keybind = port-forwarding:r=port_forwarding_restart. keybind = clear also removes those scoped defaults. The default keys are unchanged. Navigation, text entry, and terminal-local keys stay with the focused editor or terminal.
- Pi session restore (#660)With restore-tabs-on-startup = true, WispTerm saves the Pi JSONL session path and relaunches it with pi --session on the next start. Local, WSL, and SSH sessions are covered. A local path that does not belong to this machine is skipped. Closing the window asks a capable Pi session to run /wispterm-shutdown and waits up to about 2.5 seconds before the normal PTY teardown.
Fixed
- Agent question cards (#661, #662)When ask_user shows a question or option wider than the card, a horizontal scrollbar appears under the options. Drag the thumb or click the track to read the full text. Using the scrollbar does not choose an option. Each conversation keeps its own position, and a new question starts at the left edge.
- Pi history pathsA Pi session id falls back to the file name even when the path uses the other platform's separator, so a Windows path scanned on Linux (and the reverse) still yields the session id.
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.40.5.
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.40.5 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.