README.md

webtty

Terminal UI in the browser. Run CLI/TUI applications in a browser tab, across platforms. Terminal emulation by Ghostty's official libghostty-vt, with a renderer and input layer derived from ghostty-web.

• Why webtty?

bunx webtty                # open main session in the browser
bunx webtty go [id]        # open a specific session by id
bunx webtty help           # show all commands

# or with npx
npx webtty
npx webtty go [id]
npx webtty help

Windows: use npx — bunx is not supported on Windows because Bun.spawn({ terminal }) does not implement PTY on Windows yet.

Development

Build emits source maps (dist/**/*.js.map), so you can debug against the built output directly — no minification, original TypeScript line numbers preserved.

bun run build
bun --inspect run dist/server/index.js
# or
node --inspect dist/server/index.js