ReTerm

ReTerm is a local web terminal multiplexer based on vercel-labs/wterm. It uses the wterm DOM/React terminal renderer in the browser, a local node-pty backend, and a Dockview workspace for draggable dock panels, tabs, floating groups, and splits. If the host has no usable PTY devices, ReTerm falls back to a limited pipe backend so simple shell commands can still run.

Run

npx @ihasq/reterm

The command starts an HTTP server bound to 127.0.0.1 by default and prints a URL containing a one-time access token.

CLI

reterm [--host 127.0.0.1] [--port 8787] [--cwd /path/to/workdir] [--shell /bin/zsh] [--no-token]

• --host: interface to bind. Defaults to 127.0.0.1.
• --port: preferred port. Defaults to 8787; if busy, ReTerm tries the next few ports. Use 0 to request a random free port.
• --cwd: working directory for new terminal panes. Defaults to the current command directory.
• --shell: shell executable for new terminal panes. Defaults to $SHELL on Unix and PowerShell/CMD on Windows.
• --no-token: disables the local access token. Use only on trusted networks.

Development

npm install
npm run build
node dist/cli.js

The packaged CLI serves the Vite-built client from dist/public.