Name		Name	Last commit message	Last commit date
parent directory ..
app		app
.gitignore		.gitignore
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next.config.mjs		next.config.mjs
package.json		package.json
postcss.config.mjs		postcss.config.mjs
server.ts		server.ts
tsconfig.json		tsconfig.json
wterm-react.d.ts		wterm-react.d.ts

README.md

Local Shell Example

Full local terminal in the browser, connected to your machine's shell via WebSocket and node-pty.

Setup

From the monorepo root:

pnpm install
zig build
pnpm --filter local dev

Opens at local-example.wterm.localhost via portless.

How It Works

server.ts starts an HTTP + WebSocket server alongside Next.js
On WebSocket connection, a PTY process is spawned with your default shell
The browser sends keystrokes over WebSocket; the server relays PTY output back
Terminal resizing is forwarded to the PTY via a custom escape sequence

Key Files

File	Description
`server.ts`	Custom server with WebSocket ↔ PTY bridge
`app/page.tsx`	Terminal page with auto-resize and WebSocket connection
`app/layout.tsx`	Root layout with metadata