VIBECOOK / GHOSTTY-POWERED TERMINAL RUNTIME
ghosttea
Ship the Ghostty experience across platforms.
Put the terminal experience developers already love inside your product—WebGPU on macOS and Windows, native Metal on iOS.
Website ·
API guide ·
npm ·
crates.io
Why
CLI agents have made the terminal the center of modern development. Ghostty set the bar for how fast, native, and calm that surface can feel.
libghostty-vt provides the terminal core. ghosttea provides the product layer: PTYs, WebGPU and Metal surfaces, Electron lifecycle, React workspaces, typed automation, SSH, and shared sessions.
| Ship on | Integration | Renderer |
|---|
| Apple Silicon macOS | Electron + React | WebGPU |
| x64 Windows | Electron + React | WebGPU |
| iOS 18.1+ | Native Swift composition | Metal |
Run it
git clone https://github.com/vibecook-dev/ghosttea.git
cd ghosttea
npm install
npm run fetch:ghostty-vt
npm run dev
Requires Node 22+ and Rust 1.88+. Locked native artifacts are available for Apple Silicon macOS and x64 Windows.
Embed it
npm install @vibecook/ghosttea-electron @vibecook/ghosttea-react
Start high-level and drop down only when you need control:
| Need | Use |
|---|
| Complete terminal workspace | @vibecook/ghosttea-react/workspace |
| Terminal surfaces in custom UI | @vibecook/ghosttea-react |
| Electron lifecycle + transport | @vibecook/ghosttea-electron |
| Headless automation | @vibecook/ghosttea-client |
| Native composition | ghosttea + ghosttea-core |
The API guide is the shortest path from install to first terminal.
What you get
- Ghostty VT semantics, text shaping, reflow, selection, and scrollback
- Local PTYs and direct SSH
- WebGPU desktop and Metal iOS rendering
- Sandboxed Electron transport and a complete React workspace
- Versioned Ghostty configuration compatibility across desktop and Apple APIs
- Human-safe automation and logical session sharing
Local frames skip Electron main and React state. Shared sessions move terminal state—not screenshots—so each device renders sharp pixels locally.
Status
macOS and Windows desktop targets are release-gated. The native iOS app is implemented and device-tested; external release qualification remains in progress. See the qualification record.
Project
MIT © 2026 James Yong. ghosttea is a VibeCook project built independently on libghostty-vt and is not affiliated with Ghostty.
