VIBECOOK / GHOSTTY-POWERED TERMINAL RUNTIME
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
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 |
git clone https://github.com/vibecook-dev/ghosttea.git
cd ghosttea
npm install
npm run fetch:ghostty-vt
npm run devRequires Node 22+ and Rust 1.88+. Locked native artifacts are available for Apple Silicon macOS and x64 Windows.
npm install @vibecook/ghosttea-electron @vibecook/ghosttea-reactStart 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.
- 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
- 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.
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.
MIT © 2026 James Yong. ghosttea is a VibeCook project built independently on libghostty-vt and is not affiliated with Ghostty.