Skip to main content

Roomote Control

Roomote Control lets you remotely control tasks running in your local VS Code instance from the Roo Code Cloud web interface.

What is Roomote Control?​

Roomote Control creates a bidirectional connection between your local VS Code extension and Roo Code Cloud so you can:

  • Control tasks remotely — start, stop, interact, and use the full chat interface
  • Included with Roo Code Cloud Pro. See Billing & Subscriptions.

Key Features​

Real-time Workspace Connection​

  • Shows your connected workspaces and live status

Remote Task Control​

  • Chat interface — Similar to IDE chat for core interactions; some settings and customizations aren't available in the browser
  • Start New Tasks - Launch tasks in any connected workspace
  • Stop Running Tasks - Safely terminate active tasks
  • Task Switching - Navigate between tasks including resuming tasks that have been stopped or closed
Pro Feature Required for Remote Control

While basic monitoring is available to all users, remote control capabilities (starting, stopping, and interacting with tasks remotely) require a Pro subscription (free 14-day trial, then $20/month).

Getting Started​

Step 1: Connect Your Account​

First, you need to connect your Roo Code extension to Roo Code Cloud. Follow the login instructions to connect your account.

Step 2: Enable Roomote Control​

You can enable Roomote Control in two ways:

Option 1: From the Web Dashboard

  1. Navigate to app.roocode.com
  2. Toggle the Roomote Control switch on the top right of the home page

Option 2: From the Roo Code Plugin

  1. Click the cloud icon in the top right corner of Roo Code
  2. Toggle the Roomote Control switch in the Cloud panel

Step 3: Start a Remote Task​

Once your account is connected and Roomote Control is enabled:

  1. Your VS Code workspace(s) automatically appear in the web interface
  2. Click New Task on any connected workspace card
  3. Enter your task description
  4. Click Start to begin the task
  5. Watch real-time progress in your browser

Notifications​

Receive push notifications about task updates and completions without keeping the app open.

Requirements​

  • Signed in to your Roomote account on the device.
  • Supported browser with Notifications, Service Workers, and Push:
    • iPhone/iPad (iOS 16.4+): Safari installed to Home Screen is required.
    • Android: Chrome, Edge, Firefox (install optional).
    • Desktop: Chrome, Edge, Firefox, Safari 16+ on macOS (Ventura+)
  • Allow notifications when prompted by the browser/OS.

Turn it on​

Toggle location: Settings › User.

Enable Push Notifications in Settings › User
  • iPhone/iPad (Safari)
    1. Open https://app.roocode.com.
    2. Share › Add to Home Screen › Add.
    3. Launch Roo Code from the Home Screen icon.
    4. In the app: Settings › User › Push Notifications — turn On; allow the permission prompt.
  • Android (Chrome)
    1. Open https://app.roocode.com.
    2. Optional: Menu › Add to Home screen / Install app.
    3. Settings › User › Push Notifications — turn On; allow the permission prompt.
  • Desktop
    1. Open https://app.roocode.com and sign in.
    2. Settings › User › Push Notifications — turn On; allow the permission prompt.

Manage per device​

  • Location: Settings › User.
  • The Push Notifications switch controls only the current browser/device.
  • To stop notifications on a device, toggle Off there or use OS/browser notification settings for Roo Code.

What to expect​

  • A permission prompt the first time you enable notifications.
  • Alerts for task updates and completions.
  • Clicking a notification opens Roo Code, usually to the relevant task.

Troubleshooting​

  • No permission prompt: Use a supported browser, disable private/incognito mode, and ensure site notifications aren't blocked.
  • iPhone not receiving: Make sure Roo Code is installed to Home Screen, opened from the icon, and Push Notifications is On.
  • Duplicate notifications: You've enabled them on multiple devices. Turn them Off on devices you don't want.
  • Nothing arrives: Check system notification settings for Roo Code, confirm you're signed in, and that Push Notifications is On.

Limits​

  • iOS requires installing to Home Screen (iOS 16.4+).
  • Private/incognito modes and some corporate policies can block notifications or background updates.
  • An internet connection is required to receive notifications.
  • Enabling on one device does not enable on others; manage each device separately.

Limitations​

  • Requires active VS Code with Roo Code extension
  • Internet connection required for real-time sync
  • One task active per workspace at a time