Developer preview

Build from source.

No signed installer has been published yet. This page keeps that boundary explicit and documents the current Windows-first path.

Requirements

  • Windows 11 and Visual Studio Build Tools 2022
  • Rust MSVC toolchain
  • Zig 0.16.0
  • Node.js through nvm
  • Chrome or Edge for browser-driven checks
  • A supported coding CLI already signed in

Source build

Build Ghostty's VT library once, then run the workspace and app commands from the repository.

git clone --depth 1 https://github.com/ghostty-org/ghostty.git %USERPROFILE%\tools\ghostty
cd %USERPROFILE%\tools\ghostty
zig build -Demit-lib-vt -Doptimize=ReleaseFast -Dsimd=false

cd path\to\harnes
cargo test --workspace
cd app
npm install
npm run app

For an installer build, use npm run app:build after the same prerequisites are installed.

Current limits

Not a packaged release yet

There are no public GitHub Releases or signed installer artifacts in the audited repository. Treat this as a developer build, not a production distribution.

  • Windows is the documented target.
  • The Ghostty VT API is an upstream integration point that can move.
  • Provider adapters beyond the default path are best-effort.
  • The full application build needs native prerequisites beyond the web UI.

See the release-readiness board โ†’