Back to Turborepo

turborepo-ghostty

crates/turborepo-ghostty/README.md

2.10.31.2 KB
Original Source

turborepo-ghostty

Ghostty-backed virtual terminal support for Turborepo's TUI.

This crate depends on libghostty-vt for safe Rust bindings to libghostty-vt, and adds Turborepo-specific integration:

  • Parser — high-level API for task output parsing, scrolling, and selection
  • TerminalWidget — ratatui widget for rendering terminal state

Build requirements

Zig 0.15.2+ must be on PATH when building (CI installs it via setup-zig). libghostty-vt-sys fetches and compiles Ghostty sources at build time.

On Windows MSVC, Turborepo patches libghostty-vt-sys (via [patch.crates-io]) so release binaries link ghostty-vt-static.lib instead of the DLL import library. See crates/libghostty-vt-sys/README.md.

Attribution

  • Ghostty — terminal emulation via libghostty-vt. License: MIT.
  • libghostty-rs — Rust bindings (libghostty-vt, libghostty-vt-sys). License: MIT OR Apache-2.0.
  • ratatui-ghosttywidget.rs and convert.rs are adapted from its ratatui integration. License: MIT.