docs: Roomote Control — Notifications (#377)

* docs(roomote-control): add Notifications section with per-platform setup and toggle screenshot; clarify requirements and limits

* docs(roomote-control): streamline ToC by demoting Notifications subheads to H4; retain Key Features as H3

Author: hannesrudolph

docs/roo-code-cloud/roomote-control.mdx

@@ -43,11 +43,11 @@ While basic monitoring is available to all users, remote control capabilities (s
 
 ## Getting Started
 
-### Step 1: Connect Your Account
+#### Step 1: Connect Your Account
 
 First, you need to connect your Roo Code extension to Roo Code Cloud. Follow the [login instructions](/roo-code-cloud/login#getting-started) to connect your account.
 
-### Step 2: Enable Roomote Control
+#### Step 2: Enable Roomote Control
 
 You can enable Roomote Control in two ways:
 
@@ -59,7 +59,7 @@ You can enable Roomote Control in two ways:
 1. Click the **cloud icon** <Codicon name="cloud" /> in the top right corner of Roo Code
 2. Toggle the **Roomote Control** switch in the Cloud panel
 
-### Step 3: Start a Remote Task
+#### 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
@@ -68,6 +68,58 @@ Once your account is connected and Roomote Control is enabled:
 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.
+
+<img src="/img/roomote-control/roomote-control.png" alt="Enable Push Notifications in Settings › User" width="500" />
+
+- 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