wispterm

English | [简体中文](README.zh-CN.md)

# WispTerm

<p>
<a href="https://github.com/xuzhougeng/wispterm/releases"><img src="https://img.shields.io/badge/Windows-supported-0078D4" alt="Windows supported"></a>
<a href="https://github.com/xuzhougeng/wispterm/releases"><img src="https://img.shields.io/badge/macOS-supported-000000" alt="macOS supported"></a>
<a href="https://github.com/xuzhougeng/wispterm/releases"><img src="https://img.shields.io/badge/Linux-experimental-FCC624" alt="Linux experimental"></a>
<a href="https://github.com/xuzhougeng/wispterm/blob/main/LICENSE"><img src="https://img.shields.io/github/license/xuzhougeng/wispterm" alt="License"></a>
<br>
<a href="https://github.com/xuzhougeng/wispterm/stargazers"><img src="https://img.shields.io/github/stars/xuzhougeng/wispterm?style=social" alt="Stars"></a>
<a href="https://github.com/xuzhougeng/wispterm/releases"><img src="https://img.shields.io/github/v/release/xuzhougeng/wispterm?include_prereleases" alt="Release"></a>
<a href="https://github.com/xuzhougeng/wispterm/releases"><img src="https://img.shields.io/github/downloads/xuzhougeng/wispterm/total" alt="Downloads"></a>
<a href="https://github.com/xuzhougeng/wispterm/commits/main"><img src="https://img.shields.io/github/last-commit/xuzhougeng/wispterm" alt="Last commit"></a>
</p>

**WispTerm** is a cross-platform terminal workspace for remote development and AI agent workflows. It is written in Zig and powered by [libghostty-vt](https://github.com/ghostty-org/ghostty) for terminal emulation.

> [!NOTE]
> WispTerm ships for **Windows** and **macOS** (Apple Silicon and Intel). A
> **Linux** AppImage is published for community testing and remains
> experimental.
>
> The macOS app runs on **macOS 13 Ventura or later**. **macOS 12 Monterey is
> best-effort**: the app is built for it and CI rejects newer APIs, but no CI
> runner can launch macOS 12, so it is not tested there.

## Features

- **Ghostty's terminal emulation** - uses libghostty-vt for VT parsing and terminal state
- **Native font discovery** - find system fonts by name via DirectWrite, CoreText, or fontconfig, with per-glyph fallback for missing characters
- **FreeType rendering** - high-quality glyph rasterization with Ghostty-style font metrics
- **Sprite rendering** - box drawing, block elements, braille patterns, powerline symbols
- **Theme support** - Ghostty-compatible theme files, 450+ themes built in (default: Poimandres)
- **Background image and shaders** - wallpaper blending plus Ghostty-compatible GLSL post-processing
- **Splits and tabs** - vertical/horizontal splits, tab strip, focus-follows-mouse, equalize sizes
- **File Explorer and previews** - browse local, WSL, and SSH files; preview Markdown/text/tables/images/PDFs without leaving the terminal
- **Embedded browser panel** - open web URLs in a side WebView2 (Windows) or WKWebView (macOS) panel when available, with persistent SSH loopback port forwarding for profile sessions
- **SSH port forwarding manager** - sil