Mobile Local Terminal
Remish is a browser interface for a local POSIX shell. The server and shell run on the same computer.
- Node.js 18 or later
- npm
- A C compiler
- macOS, Linux, or another POSIX system with
forkpty
- Run
npm ci. - Run
npm start. - Open
http://localhost:8787/in a browser on the same computer.
To connect from another computer, open http://<server-ip>:8787/.
The start command builds bin/local-pty from src/local-pty.c.
WARNING: The server listens on all IPv4 interfaces by default. Do not run the server on an untrusted network. The application has no user authentication. A connected browser can control the shell that runs on the server.
Set HOST=127.0.0.1 to accept connections only from the same computer.
The server keeps terminal output only in memory. The output is lost when the server stops. The browser stores only the active tab, font size, and toolbar usage in local storage. The shell can store its own history and configuration.
Run npm run build to build the local PTY helper without starting the server.
This code uses the MIT License. Read LICENSE for the license text. Read THIRD_PARTY_NOTICES.md for package credits and license information.