remotego - Expose Any CLI as a Public Web Terminal#

Mirror any CLI tool in a browser with a public URL. Share your terminal with anyone over the internet.

When to Use#

The user wants to:

• Share their terminal session with someone remotely
• Access a CLI tool from a browser
• Collaborate on a terminal session in real-time
• Expose a local CLI to a public URL

How to Use#

remotego is installed globally via npm. Run it with any command:

bash

remotego <command> [command-args...] [options]

Quick Examples#

GoalCommandMirror Claude Coderemotego claudeMirror bashremotego bashMirror Python REPLremotego python3 -iMirror vimremotego vimMirror Node.js REPLremotego nodeCustom portremotego --port 9000 bashCustom tunnel domainremotego --domain myterm.localhost.run bashPass flags to commandremotego -- git log --oneline

Options#

FlagDescriptionDefault--port <port>Local HTTP port7681``--cwd <dir>Working directoryCurrent dir--domain <domain>Custom localhost.run domainRandom--help, -hShow help

Install First (if not installed)#

bash

npm install -g @remotego/remotego

Or use without installing:

bash

npx @remotego/remotego bash

What Happens#

1. Spawns the command in a PTY (pseudo-terminal)
2. Starts a local HTTP server with xterm.js browser terminal
3. Creates a public tunnel via localhost.run
4. Opens the browser automatically with a session URL

Security Model#

• A random session UUID is generated on each start
• The session ID is embedded in the URL — only URL holders can connect
• Clients must authenticate within 5 seconds of connecting

Stopping#

Press Ctrl+C in the terminal running remotego.

Troubleshooting#

IssueSolutionnode not foundInstall from https://nodejs.org/Tunnel failsCheck if SSH port 22 is blocked; falls back to localhostPort in useUse --port to specify a different portBrowser doesn't openManually open the URL shown in terminal output