remotego

Expose any CLI tool as a public web terminal via tunnel.

Install

npm install -g @remotego/remotego

Usage

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

Options

| Option | Description | Default | |--------|-------------|---------| | --port <port> | Port to listen on | 7681 | | --cwd <dir> | Working directory for the command | Current directory | | --domain <domain> | Custom domain for localhost.run tunnel | Random subdomain | | --help, -h | Show help | |

Examples

# Mirror Claude Code
remotego claude

# Mirror a bash shell
remotego bash

# Mirror Python REPL
remotego python3 -i

# Mirror vim editor
remotego vim

# Custom port
remotego --port 9000 node

# Custom tunnel domain
remotego --domain myterm.localhost.run bash

# Pass flags to the command (use -- to separate)
remotego -- git log --oneline

How It Works

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

Security

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

Claude Code Plugin

This project also works as a Claude Code plugin. Install it and use the /remoting slash command to mirror your Claude Code session in a browser.

License

MIT