Ship the Ghostty experience. Across every screen.
ghosttea turns libghostty-vt into an embeddable WebGPU runtime for Electron
and a native Metal runtime for iOS—so your IDE, agent, or productivity app can feel like the terminal
developers already love.
npm i @vibecook/ghosttea-electron @vibecook/ghosttea-react
product visualization
one runtime / three surfaces
~/work/agent-workspace
80 × 24
❯ codex --resume
OpenAI Codex · agent session restored
› Add a command palette to the terminal workspace.
• Read 17 files
• Updated workspace actions and shortcuts
✓ 148 tests passed in 12.4s
Ready for review.
C:\work\agent-workspace
shared
› Add a command palette to the terminal workspace.
• Synced from the active session
• Running package checks
✓ 148 tests passed
Ready for review.
9:415G 100%
ghosttea
•••
agent-workspace
control
› Add a command palette to the terminal workspace.
• Session attached
• Changes synced
✓ 148 tests passed
Ready for review.
macOS / WebGPU
Windows / WebGPU
iOS / Metal
libghostty-vt
Open source / MIT
01 / architecture
One terminal core.
Native pixels everywhere.
Your product owns the interface. ghosttea owns terminal state, process lifecycle, ordered input, and the shortest path to the local GPU.
ghosttea / system map
Electron + React
One ordered terminal core.
session sources
local PTY · direct SSH · shared replica
terminal engine
libghostty-vt
product layer
lifecycle · authority · automation
WebGPU
macOS + Windows
worker-owned renderer
Metal
iOS
native terminal view
Sharp terminal pixels inside your interface.
02 / purpose
The terminal developers love. Now inside the products they build.
CLI agents have turned the terminal into the center of modern development. Ghostty set the bar for how fast, native, and calm that surface can feel.
ghosttea brings that terminal core into IDEs, AI workbenches, and productivity apps—without rebuilding VT semantics, GPU rendering, PTYs, automation, and session continuity from scratch.
03 / what it changes
One terminal core.
Three native surfaces.
Your product on top.
Start with a complete workspace or compose only the runtime layers your product needs.
01
Feels like Ghostty
The same pinned VT core, native text shaping, reflow, selection, scrollback, and GPU-first rendering.
02
Drops into Electron
Ship the same terminal workspace on macOS and Windows with typed lifecycle APIs and a sandboxed bridge.
03
Goes native on iOS
Connect over SSH or carry a live logical session to a locally rendered Metal surface on iPhone or iPad.
Truffle / remote sessions
A live terminal.
Replicated, not streamed.
Truffle carries ordered terminal state to another device. ghosttea rebuilds the view there and renders every pixel locally with WebGPU or Metal.
authoritative host
keeps running
The process
stays put.
PTY · Ghostty VT · source of truth
Truffle
ordered
terminal state → no screenshots
no video stream
terminal state → no screenshots
no video stream
remote replica
follows live
The view
comes with you.
WebGPU desktop · Metal iOS · local pixels
Same live session. Native resolution on every screen.
Host stays authoritative. Input and resize control remain explicit.
Packages / choose a layer
Start high-level.
Drop down deliberately.
Six npm packages and six published Rust crates share one version contract.
01
@vibecook/ghosttea-react
workspace · surfaces · rendering
02
@vibecook/ghosttea-electron
lifecycle · transport · automation
03
@vibecook/ghosttea-client
headless Node control
04
@vibecook/ghosttea
browser control plane
05
protocol + frame
typed contracts · TRF1 decoder
06
ghosttea + ghosttea-core
native service · terminal model
VibeCook / ghosttea
Ship the terminal experience
your users already want.
Bring Ghostty-powered terminal behavior to your Electron or native iOS product without starting from a blank emulator.