ts-libghostty

Bun-workspaces monorepo for TypeScript bindings around Ghostty's VT state machine.

Packages

• packages/libghostty-vt/ — npm libghostty-vt. Direct binding over libghostty-vt: Terminal, RenderState, Formatter, effect callbacks, color management. Self-contained; usable for parsing recorded VT streams or any context where you need the model layer.
• packages/blinkyterm/ — npm blinkyterm. Agent-facing Runner over Bun.Terminal plus libghostty-vt, with async frame iteration and send helpers.

Development

Requires Bun ≥ 1.3.13 and a one-time native toolchain setup (zig 0.15 via brew). See packages/libghostty-vt/README.md for the binding's build instructions.

bun install                                        # workspace install
cd packages/libghostty-vt && bun test test/smoke   # binding tests

License

Apache-2.0 for ts-libghostty source. See LICENSE at the root and per-package licenses for any bundled third-party material (e.g., packages/libghostty-vt/LICENSE_GHOSTTY for the dylib).

About

Copyright 2026 Prime Radiant https://primeradiant.com