- name
- remotego
- description
- Expose any CLI tool as a public web terminal via tunnel. Mirror bash, vim, python, node, or any command in a browser for remote access and collaboration.
- version
- 1.1.0
- metadata
- openclaw
- requires
- bins
- emoji
- 🌐
- homepage
- https://github.com/topcheer/claude-remoting
- os
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:
remotego <command> [command-args...] [options]Quick Examples
| Goal | Command |
|---|---|
| Mirror Claude Code | remotego claude |
| Mirror bash | remotego bash |
| Mirror Python REPL | remotego python3 -i |
| Mirror vim | remotego vim |
| Mirror Node.js REPL | remotego node |
| Custom port | remotego --port 9000 bash |
| Custom tunnel domain | remotego --domain myterm.localhost.run bash |
| Pass flags to command | remotego -- git log --oneline |
Options
| Flag | Description | Default |
|---|---|---|
--port <port> | Local HTTP port | 7681 |
--cwd <dir> | Working directory | Current dir |
--domain <domain> | Custom localhost.run domain | Random |
--help, -h | Show help |
Install First (if not installed)
npm install -g @remotego/remotegoOr use without installing:
npx @remotego/remotego bashWhat Happens
- Spawns the command in a PTY (pseudo-terminal)
- Starts a local HTTP server with xterm.js browser terminal
- Creates a public tunnel via localhost.run
- 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
| Issue | Solution |
|---|---|
node not found | Install from https://nodejs.org/ |
| Tunnel fails | Check if SSH port 22 is blocked; falls back to localhost |
| Port in use | Use --port to specify a different port |
| Browser doesn't open | Manually open the URL shown in terminal output |