WINRecommended for Windows
Windows portable
Choose this for most Windows PCs. Extract the zip and run wispterm.exe without an installer.
SHA25691e967e062be93745de918717c5566e27ad733a894c88c7eb7a04ffb8a8e5dd1
Download ZIPOPEN SOURCE · WINDOWS & MACOS
Latest release v1.36.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.36.0.dmgDOWNLOADS
Choose the package for your machine.
These are the current Windows and macOS assets from the v1.36.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.
SHA2566fcae044dad5ae58bdc54cc429581d2e61544164de9061666228da74338f8e1e
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.
SHA25621644582998743d245a8b4f147abcaa5a6863cb3d27a0cbd463731fd51130285
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.
SHA2561957f8b64fd9848efe5841bcfb80045ad34bd11d96125ec6a5261f1e1e014d9d
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.
SHA25696014c526090a26917bb6386f5e8d659b1713dfca9e659f6c46039db045cff29
Download DMGWHAT'S NEW
What changed in v1.36.0
The key additions and fixes from this release, summarized from the official GitHub release notes.
Added
- Local↔SSH dataset transfer (#614)Agents can copy one file or directory between local disk and an SSH host with transfer_between_contexts, using the same recursive scp path as File Explorer. Destinations are never overwritten.
Fixed
- macOS quit deadlock (#611, #612)Cmd+Q no longer hangs for 30 seconds with a beachball. Extra windows destroy NSWindow via dispatch_sync onto the main queue; quit now keeps pumping that queue until worker threads finish instead of blocking in join.
- Agent SSH/WSL heredoc hang (#609, #615)Session exec no longer wraps the user command in { } 2>&1; __wispterm_agent_status=$?. Nested heredocs are written to a temp script and sourced in the current shell, so the closer cannot be swallowed by heredoc> PS2. A stuck heredoc prompt is treated as still-running, not idle.
- Copilot queue and permission chip (#613)The queued-prompts overlay closes when the queue drains instead of covering the transcript at Queued Prompts (0). Full / Auto / Ask is clickable in the compact sidebar.
- OSC color titles and zombie PTYs (#608)OSC 10/11 color payloads are no longer applied as window titles, and child processes are reaped so they do not linger after exit.
- Linux desktop host (#599–#605)First-launch freeze, titlebar drag vs caption buttons, keyboard shortcuts (paste, command center, splits), and SDL window drag/resize now work on the experimental Linux build.
Changed
- Titlebar chrome icons (#606)Gear/help cluster icons are cleaner; the app mark is unchanged.
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.36.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.36.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.