feat: Add Tunnelmole integration for remote access #63
Conversation
- Add Tunnelmole npm package for creating secure tunnels - Create tunnel service manager to handle tunnel lifecycle - Add API endpoints for tunnel control (start/stop/status/share) - Update QuickSettingsPanel with Network Access section - Add toggle to enable/disable Tunnelmole from UI - Display tunnel URL with copy and share functionality - Generate QR codes for easy mobile access - Update WebSocket connection to use tunnel URL when active - Configure Vite to allow external host access (allowedHosts: true) - Fix port configuration to use correct ports in development This feature allows users to expose their local Claude Code UI instance to the internet securely, making it accessible from mobile devices or external networks with a simple toggle in the settings panel.
|
@dario-valles I like the idea but why not use Localtunnel instead ? |
|
"Good question! I wasn't aware of Localtunnel before. Both are indeed open source, which is great. I chose Tunnelmole because: It offers persistent custom domains (paid tier) so you can keep the same URL across sessions That said, Localtunnel is completely free and simpler if you just need basic tunneling. I'm not affiliated with either service - just picked what worked best for my needs. |
|
There’s also Cloudflare Tunnel, but there are too many options. I think you can run this project in Docker, expose the port, and host it on a server with a public IP. In a pure environment, tunnels may not be necessary. |
Summary
Motivation
Users often need to access their Claude Code UI instance from mobile devices or external networks. This feature provides a secure and easy way to create temporary tunnels without complex network configuration.
Changes
Backend:
server/services/tunnelService.js)server/routes/tunnel.js)Frontend:
Configuration:
tunnelmoleandqrcodenpm dependenciesScreenshots
Testing
npm installto install new dependenciesnpm run devSecurity Considerations
allowedHosts: trueis only set in development mode