/remoting - Mirror Claude Code in a Browser#

Expose the current Claude Code session as a public web terminal. Anyone with the URL can view and interact with the terminal from their browser.

When to Use#

The user says something like:

• "Share my terminal"
• "Mirror my Claude session"
• "Let someone watch my screen"
• "Remote access to this terminal"
• "Open in browser"

Quick Start#

Install and launch:

bash

# If not already installed
npm install -g @remotego/remotego

# Start mirroring Claude Code
remotego claude

Or run without installing:

bash

npx @remotego/remotego claude

With Options#

bash

# Custom port
remotego claude --port 9000

# Custom tunnel domain (localhost.run)
remotego claude --domain myterm.localhost.run

# Custom working directory
remotego claude --cwd ~/my-project

What the User Sees#

1. Terminal output shows:
   • Local URL: http://localhost:7681?session=<uuid>
   • Public URL: https://xxxxx.lhr.life?session=<uuid>
2. Browser opens automatically with the public URL
3. Terminal output from Claude Code appears in the browser in real-time
4. Browser users can type and interact with the session

Security#

• Random session UUID per start — only URL holders can connect
• 5-second auth timeout for new connections
• All output is cached so new viewers see full history

Stopping#

Press Ctrl+C in the terminal, or the user can type /exit.

Troubleshooting#

IssueSolutionnode not foundInstall from https://nodejs.org/Tunnel failsFalls back to localhost URL; check SSH port 22Port in useUse --port to pick another