https://github.com/prime-radiant-inc/ts-libghostty

Bun-workspaces monorepo of TypeScript bindings around Ghostty's VT state machine: libghostty-vt (Terminal/RenderState/Formatter model layer) and blinkyterm (agent-facing terminal Runner).
https://github.com/prime-radiant-inc/ts-libghostty

bindings bun ghostty terminal typescript

Last synced: 9 days ago
JSON representation

Bun-workspaces monorepo of TypeScript bindings around Ghostty's VT state machine: libghostty-vt (Terminal/RenderState/Formatter model layer) and blinkyterm (agent-facing terminal Runner).

• Host: GitHub
• URL: https://github.com/prime-radiant-inc/ts-libghostty
• Owner: prime-radiant-inc
• License: apache-2.0
• Created: 2026-04-23T21:30:12.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-06-09T22:35:58.000Z (12 days ago)
• Last Synced: 2026-06-09T23:09:54.691Z (12 days ago)
• Topics: bindings, bun, ghostty, terminal, typescript
• Language: TypeScript
• Size: 1.83 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ts-libghostty

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

state machine.

## Packages

- [`packages/libghostty-vt/`](./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/`](./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.

```bash

bun install                                        # workspace install

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

```

## License

Apache-2.0 for ts-libghostty source. See [LICENSE](./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](https://primeradiant.com)