Remote Agent Bridge

Zero-config mobile bridge for your IDE's AI coding agents
Dispatch prompts, approve tools, and monitor live progress from your phone or tablet.

💡 Why Remote Agent Bridge?

Modern autonomous AI coding agents like Claude Code, Cline, GitHub Copilot, Roo Code, Continue, and Antigravity can work through complex programming workflows, write tests, refactor architectures, and debug issues across dozens of files.

However, using them usually means being tethered to your desk:

• Waiting for long agent runs to complete before typing the next prompt.
• Sitting idle while waiting to click "Approve" for terminal commands or file changes.
• Running tedious tunnel software (cloudflared, ngrok, port-forwarding) just to get remote access.

Remote Agent Bridge eliminates all of that. Walk away from your desk, make coffee, or commute while staying completely in control of your coding agents from your phone or any web browser.

✨ Features

• 📱 Responsive Mobile Web Console: Beautiful dark-mode web console optimized for iOS Safari and Android Chrome. Add it to your home screen as a standalone Progressive Web App (PWA).
• 🤖 Multi-Agent Auto-Detection: Seamlessly detects and interfaces with:
  • 🟣 Claude Code (Anthropic Claude Code Agent)
  • 🧠 Cline (Autonomous Coding Agent)
  • 🐙 GitHub Copilot Chat
  • 🦘 Roo Code (Adaptive AI Agent & Custom Modes)
  • ⏩ Continue (Open-source AI coding assistant)
  • 🌌 Antigravity (Google DeepMind Antigravity Agent)
• ⚡ Interactive Tool & Permission Approvals: Approve or reject command executions, file modifications, and answer multiple-choice questions (ask_question) directly on your mobile device.
• 🔴 Real-Time Streaming: Watch thoughts, subagent executions, and markdown responses stream live back to your screen.
• 📜 Full Session History & Switching: Switch between ongoing or historical agent sessions without touching your desktop.
• 📊 Live Model Usage & Metrics: Keep track of execution turns, tool invocations, and estimated token counts in real time.
• 📷 Image & Camera Attachments: Take a picture of your whiteboard, wireframe, or device screen and dispatch it straight to the agent with your prompt.
• 🔒 Zero Network Configuration: Uses an outbound WebSocket connection from your editor. No open ports, no static IPs, and no tunnel daemons required.

🏗️ Basic Architecture

 ┌──────────────────────┐         ┌─────────────────────────┐         ┌──────────────────────┐
 │   📱 Mobile Device   │  HTTPS  │  ☁️ Cloudflare Worker   │   WSS   │   💻 Local IDE       │
 │   (Browser / PWA)    │◄───────►│      Relay Gateway      │◄───────►│  (Extension Client) │
 └──────────────────────┘   WSS   └─────────────────────────┘         └──────────────────────┘
   • Mobile Web Console             • Durable Object Matchmaker         • Auto-detects Agents
   • 1-Click Pairing Token          • Ephemeral Room Routing            • Dispatches Prompts
   • Interactive Approvals          • Zero Cloud Storage                • Watches Transcripts
   • Live Response Stream                                               • Resolves Permissions

How It Works:

1. Outbound Connection: On IDE startup, the extension establishes a secure, outbound WebSocket connection to the Cloudflare Worker Relay Gateway. Because the connection is outbound, it works automatically behind firewalls, NAT routers, and VPNs without port forwarding.
2. Ephemeral Pairing: A secure pairing token (ra-...) uniquely identifies your editor instance. When you open the console on your phone (via 1-click link or QR code), the mobile browser joins the matching room.
3. Prompt Dispatch & Interactivity: Prompts and attachments sent from your phone are dispatched to the selected agent extension. If the agent asks for confirmation or permission, the bridge pushes the prompt to your phone and sends your response back to the IDE.
4. Privacy First: The relay is purely an ephemeral in-memory router. No code, prompts, or sensitive files are ever saved on intermediate servers.

🚀 How to Use (Quick Start)

Step 1: Install the Extension

Install Remote Agent Bridge from your editor:

• VS Code:

  code --install-extension navneet.remote-agent-bridge
  

• VSCodium / Eclipse Theia (Open VSX):

  codium --install-extension navneet.remote-agent-bridge
  

• From UI: Press Ctrl+Shift+X (or Cmd+Shift+X on macOS), search for Remote Agent Bridge, and click Install.

Once installed, the extension automatically activates. You will see the status item in your bottom status bar:

📡 Remote: Online

Step 2: Connect Your Phone (Choose Either Method)

Method A: Direct Link (Recommended)

1. Click the 📡 Remote: Online status bar button.
2. Select "Copy Direct Mobile Link" from the quick pick menu.
3. Send this link to your phone (via WhatsApp, Telegram, Notes, Slack, or email) and tap to open it.
4. Your pairing token is pre-filled automatically!

Method B: QR Code Scan

1. Open the Remote Agent icon in the VS Code Activity Bar (left sidebar).
2. Point your phone camera at the QR code displayed in the sidebar.
3. Tap the prompt to open the console in your mobile browser.

Step 3: Send Prompts & Monitor Execution

1. In the mobile console, tap the tab for your desired agent (Claude Code, Cline, Copilot, Roo, Continue, or Antigravity).
2. Type your prompt, or tap the camera icon to attach an image.
3. Tap ⚡ Send.
4. Watch the agent stream its response and thought process live on your phone!

💡 Tip — Add to Home Screen (PWA):

• iOS (Safari): Tap the Share button at the bottom → tap Add to Home Screen.
• Android (Chrome): Tap the Menu (⋮) at top right → tap Add to Home screen (or Install app). Now you have a standalone app icon on your phone's home screen!

🎮 Interactive Approvals

When an agent requests human permission to execute an action (e.g. running a bash command, modifying a file, or answering an ask_question prompt):

1. An Approval Card instantly pops up on your phone console with details about the tool or question.
2. Tap Approve, Reject, or pick the appropriate option directly from your phone.
3. Your decision is relayed back to your IDE immediately, allowing the agent to continue its task without interruption.

⌨️ Extension Commands

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and search for Remote Agent:

⚙️ Extension Settings

Accessible via Settings (Ctrl+,) under Remote Agent Bridge:

🔒 Security & Privacy

• No Inbound Open Ports: The bridge never exposes any local port or web server to the internet. Connections are outbound-only to Cloudflare's edge network.
• Token Authentication: All communications are segmented into isolated rooms keyed by a cryptographically random token.
• In-Memory Routing: Prompts, progress messages, and diffs are streamed purely in memory between your paired phone and IDE; nothing is stored on cloud databases.

🌐 Self-Hosting the Relay Gateway (Optional)

The relay gateway runs on Cloudflare Workers and Durable Objects. If you prefer to host your own instance:

# Clone the repository
git clone https://github.com/maxandroid24/remote-agent-bridge.git
cd remote-agent-bridge/remote-agent-gateway

# Install dependencies and deploy
npm install
npx wrangler login
npm run deploy

Once deployed, set remoteAgent.workerUrl in your VS Code settings to your deployed worker URL.

📄 License

MIT License © 2026 Navneet