Roo Code Cloud fixes (and minor style tweaks)

Author: brunobergher

docs/roo-code-cloud/analytics.mdx

@@ -16,16 +16,13 @@ redirect_from:
 
 # Analytics
 
-Analytics lets you track tokens, tasks, estimated cost, and Cloud Agent credits at a glance.
+Analytics lets you track tokens, tasks, inference cost, and Cloud Agent credits usage in aggregate or according to arange of filters, defined by you. It's all free.
 
 ## Access
 
-- Open the Analytics tab in the web app, or go directly to https://app.roocode.com/usage
+- Just go to the [Analytics](https://app.roocode.com/usage) tab
 
-## Metrics and filters
-
-- Time ranges: Today, 7d, 30d, 90d, or All Time
-- Filters: task source (All, Workspace Tasks, Cloud Tasks), Creator, Repository
-- Metrics: tokens (input/output), tasks, estimated cost, and Cloud Agent credits
-- Views: stacked bar chart with tabs for Tokens, Inference (cost), and Tasks; tables grouped by Creators, Models, and Repositories with totals and last‑activity timestamps.
+## What's tracked
 
+- For Cloud Agents, all tasks are tracked and considered for analytics
+- For the extension, only taks you run while logged in get reported for analytics. You can turn off [task sync](/roo-code-cloud/task-sync) so the contents of tasks aren't sent to Cloud, but usage numbers are always reported while you'r elogged into the extension. That allows you to keep certain tasks away from Cloud while still benefiting from usage analytics.

docs/roo-code-cloud/billing-subscriptions.mdx

@@ -18,105 +18,43 @@ import PlanBox from '@site/src/components/PlanBox';
 
 Roo Code Cloud offers three subscriptions: Free, Pro and Teams.
 
+You can find details for them [in the pricing page](https://roocode.com/pricing).
 
+## How to Upgrade
 
-<PlanBox
-  title="Free Forever Plan"
-  subtitle="Included with every account"
-  id="free-plan"
-  icon="Sparkles"
-  price="$0/mo"
-  checklist
->
-  <ul>
-    <li><a href="/roo-code-cloud/task-sync">Task Sync / Monitoring</a></li>
-    <li><a href="/roo-code-cloud/analytics">Analytics</a></li>
-    <li><a href="/roo-code-cloud/task-sharing">Task Sharing</a></li>
-  </ul>
-</PlanBox>
-
-
-<PlanBox
-  title="Pro Plan"
-  subtitle="14 day free trial"
-  id="pro-plan"
-  icon="Star"
-  price="$20/mo"
-  checklist
->
-  <ul>
-    <li><a href="/roo-code-cloud/roomote-control">Roomote Control</a></li>
-    <li>Priority support</li>
-    <li>Access to <a href="/roo-code-cloud/cloud-agents">Cloud Agents</a> ($5/hour for Cloud tasks)</li>
-  </ul>
-</PlanBox>
-
-
-<PlanBox
-  title="Team Plan"
-  subtitle="14 day free trial"
-  id="teams-plan"
-  icon="Users"
-  price="$99/mo"
-  checklist
->
-  <ul>
-    <li>$99/mo flat rate for unlimited team members (each member gets everything in Pro)</li>
-    <li>Admin‑managed billing and organization settings</li>
-    <li>Team‑wide <a href="/roo-code-cloud/analytics">Analytics</a> and <a href="/roo-code-cloud/cloud-agents">Cloud Agents</a></li>
-    <li><a href="/roo-code-cloud/slack-integration">Slack Integration</a> for Cloud tasks (Coming soon)</li>
-    <li>
-      <a href="/basic-usage/mcp-marketplace">MCP Marketplace</a> curation for your teams
-      <ul>
-        <li>Hide all marketplace MCPs or selectively hide specific ones</li>
-        <li>Add your own MCPs to the marketplace</li>
-      </ul>
-    </li>
-    <li>
-      Centralized teams <a href="/basic-usage/api-configuration-profiles">API Provider</a> controls
-      <ul>
-        <li>Enable/disable providers</li>
-        <li>Limit to specific models</li>
-        <li>Create named <a href="/basic-usage/api-configuration-profiles">provider configurations</a></li>
-      </ul>
-    </li>
-  </ul>
-</PlanBox>
-
-## Getting Started
-
-1. Open Billing: [app.roocode.com/billing](https://app.roocode.com/billing)
-2. Choose Pro or Team and select Start trial.
-3. Complete checkout in Stripe; you’ll return to the app.
-4. Verify your plan shows Active. [Roomote Control](/roo-code-cloud/roomote-control) unlocks immediately for eligible plans.
-5. Team only: if prompted, create an organization, then invite teammates from Billing or the navbar.
+1. Once logged in, go to Billing: [app.roocode.com/billing](https://app.roocode.com/billing)
+2. Choose your plan and start a trial.
+4. Team only: if prompted, create your organization.
+5. Complete checkout process; you’ll be redirected back to the app.
+6. You'll be invited to create your first Cloud Agent. You can follow the process or go to the home page.
+7. In the home page. [Roomote Control](/roo-code-cloud/roomote-control) unlocks immediately (look under "Connected Workspaces").
+8. Team only: from here on you'll be able to invite your team maters.
 
 ## Managing Your Subscription
 
 - Select Manage Subscription to open Stripe’s portal for payment methods, invoices, and billing details.
-- To cancel:
+- To cancel (sorry to see you go!):
   1) Open your Billing page
   2) Click Manage Subscription
   3) Choose Cancel plan in the Stripe portal and confirm
 - During a trial, cancel before it ends to avoid the first charge. After billing, features remain active until the end of your current period. You can resubscribe anytime.
 
 ## Cloud Agents & Credits
 
-- Requires an active Pro or Team plan to create and run Cloud Agents.
-- Cloud Agents run in Roo Code Cloud and consume credits by runtime hour.
-- Model inference uses your own provider keys (no model markups).
-- Track usage and costs in [Analytics](/roo-code-cloud/analytics).
-- Learn more: [Cloud Agents](/roo-code-cloud/cloud-agents)
+- [Cloud Agents](/roo-code-cloud/cloud-agents) are only available in paid plans.
+- Cloud Agents run in Roo Code Cloud and consume credits proportional to their run time.
+- Model inference uses your own provider keys (no model markups!).
+- To top up credits, go to [Billing](https:/app.roocode.com/billing) and add them
+- Track usage and costs alongsite other stats in [Analytics](/roo-code-cloud/analytics).
 
 ## Payment & Security
 
 #### Payment Processing
 - Payments are securely processed through Stripe
-- We never store your credit card information
-- PCI‑compliant payment handling
+- We never access or store your credit card information
 
 #### Billing Cycle
 - Monthly billing on the same date each month
 - Automatic renewal unless canceled
 - Immediate access upon payment
-- Prorated refunds not available
+- Prorated refunds not available

docs/roo-code-cloud/cloud-agents.mdx

@@ -13,75 +13,54 @@ image: /img/social-share.jpg
 
 # Cloud Agents
 
-Roo Code Cloud Agents run Roo Code in the cloud so work continues when your IDE isn’t open. You can start tasks from the web, monitor progress on any device, and share links safely—while keeping model choice and pricing with your own API keys.
+Roo Code Cloud Agents can run entire tasks on their own in the cloud, often automatically, so you're not limited to typing instructions in your IDE. 
 
 ## What Roo Code Cloud Agents are
 
-Hosted, headless Roo instances that:
-- Run tasks in cloud containers independent of your local IDE
+Hosted, headless Roo-backed agents who:
+- Run tasks in cloud containers independent of your local IDE (you don't even need to use the Roo Code VS Code extension in order to use Cloud agents)
+- Have focused, optimized prompts for specific needs
 - Stream task history in the [web app](https://app.roocode.com)
-- Support shareable links for review and handoff; see [Task Sharing](/roo-code-cloud/task-sharing)
-- Respect organization and user settings (Task Sync, Roomote Control, sharing)
+- Fit into your broader workflow, outside of the editor
 
-## How billing works
-
-- Requires an active Pro or Team plan to create and run Cloud Agents; manage plans in [Billing & Subscriptions](/roo-code-cloud/billing-subscriptions).
-- Cloud runtime is billed in credits per agent‑hour.
-- Model inference is billed by your provider (bring your own API keys). No model markups.
-- Track usage and credits in [Analytics](/roo-code-cloud/analytics); switch the metric to credits.
-
-## Getting started
-
-1. Sign in and connect your account: [Login/Signup](/roo-code-cloud/login).
-2. Ensure your organization allows Task Sync and Roomote Control if you need remote actions; see [Roomote Control](/roo-code-cloud/roomote-control).
-3. Purchase credits by clicking the $ balance at the top of the web app.
-4. Create or start a Cloud Agent and watch progress in real time in the [web app](https://app.roocode.com).
-
-## Agents
+## Agents Types
 
 Cloud Agents come in different types optimized for specific workflows. Each uses your chosen model and API key, running in the cloud so work continues without your IDE.
 
-<details>
-<summary><strong>Generalist</strong></summary>
-
-:::warning Not Yet Available
-This agent type is not yet available. Check back soon for updates.
-:::
-
-Runs versatile, on‑demand cloud coding tasks using your chosen model; streams progress and tracks costs.
+### **PR Rooviewer**
+  
+Automatically reviews GitHub pull requests using your model, posts feedback, and tracks costs—triggered by webhooks or run on demand.
 
-**What you can do**:
-- Launch manual tasks from the app with a natural‑language brief
-- Tackle broad work: refactors, feature scaffolding, code analysis, documentation, and more
-- Choose provider and model per agent; add custom guidance for desired style/constraints
-- Monitor progress live in the app's streaming view and review outputs afterward
+### Coming soon
 
-**Automation**: Manual-only. No webhook triggers; jobs start when you click Run or submit a task from the app.
-</details>
+We have more agents in the works, such as:
+- PR Fixer
+- String Translator
+- Security Auditr
+- Generalist
 
-<details>
-<summary><strong>PR Rooviewer</strong></summary>
+## How billing works
 
-Automatically reviews GitHub pull requests using your model, posts feedback, and tracks costs—triggered by webhooks or run on demand.
+- Cloud Agents require an active paid plan.
+- Cloud runtime is billed in credits per agent‑hour (we charge you while the agents are working, that's it)
+- Model inference is billed by your provider (bring your own API keys). We don't mark inference costs up and are provider-agnostic
+- You can track usage and credits in [Analytics](/roo-code-cloud/analytics); switch the metric to credits.
 
-**What you can do**:
-- Automatic reviews when PRs open, become ready for review, or receive new commits
-- Manual reviews from the app on any open PR in your scope
-- Scope by repository and author; control whether to review draft PRs
-- Add custom guidance for model-specific instructions
-- Track progress via "Follow Along" links
+## Getting started
 
-**Automation**: Agent responds to GitHub webhook events (PR opened, ready for review, new commits). Eligibility depends on repo selection, author filter, and draft settings.
+1. [Sign up](http://app.roocode.com/sign-up) for a Roo Code Cloud account
+2. Upgrade to a paid plan.
+3. You'll get free credits to get started
+4. [Create your first ](https://app.roocode.com/cloud-agents/create).
 
-</details>
 
 ## FAQ
 
 - Can I run multiple agents?
   - Yes. Each agent incurs its own runtime credit usage while running.
 
 - Do I need to use a specific model?
-  - No. Use your preferred provider and models with your own API keys; inference is billed by that provider.
+  - No. We recommend a few models we've tested and found to work well, but you're free to use absolutely any model your provider offers.
 
 - Where do I see costs?
   - Track runtime credits and usage in [Analytics](/roo-code-cloud/analytics); see [Billing & Subscriptions](/roo-code-cloud/billing-subscriptions) for plans and credits.

docs/roo-code-cloud/login.mdx docs/roo-code-cloud/connect.mdxdocs/roo-code-cloud/login.mdx renamed to docs/roo-code-cloud/connect.mdx

@@ -1,5 +1,5 @@
 ---
-title: Login
+title: Connect the Extension to Cloud
 description: Connect your Roo Code extension to Roo Code Cloud for syncing, history, and collaboration.
 keywords:
   - Roo Code Cloud login
@@ -18,10 +18,3 @@ Connect Roo Code to Roo Code Cloud to link your editor with the web app for task
 1. In Roo Code, click the cloud icon <Codicon name="cloud" /> and select Connect.
 2. Choose a sign-in method (GitHub/Google OAuth or Email) on app.roocode.com.
 3. You’ll be returned to VS Code with your account connected.
-
-## Choose how to sign in
-
-- OAuth (e.g., GitHub, Google): fastest; no password stored by Roo. Your workspace may enable additional providers.
-- Email/password: standard account; secure hashing and HTTPS.
-
-

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

@@ -20,8 +20,14 @@ Roomote Control lets you remotely control tasks running in your local VS Code in
 
 Roomote Control creates a bidirectional connection between your local VS Code extension and Roo Code Cloud so you can:
 
-- Control tasks remotely — start, stop, and interact using the browser chat
-- Requires an active entitlement (Pro or qualifying org plan). See [Billing & Subscriptions](/roo-code-cloud/billing-subscriptions).
+- Keep working on long-running tasks after you step away from your computer
+- Start tasks remotely, including from your phone
+- Answer questions and ensure Roo doesn't get stuck
+- Receive push notifications about task progress and questions from Roo
+- Get the most from Roo without having any code leave your computer
+
+Roomote Control is available in our [paid plans](https://rocode.com/pricing).
+
 
 ## Key Features
 
@@ -32,21 +38,26 @@ Roomote Control creates a bidirectional connection between your local VS Code ex
 - Single active task per workspace is enforced
 
 :::note Requirements
-- Task Sync must be enabled; turning Task Sync OFF also turns Remote Control OFF.
-- Remote Control setting must be ON (Web: Settings › User › Roomote Control; IDE: Cloud panel <Codicon name="cloud" />).
-- Pro or Team entitlement required; your organization’s policy must allow Roomote Control.
+- A paid plan
+- Task Sync must be enabled
+- Remote Control must be enabled
 - Your IDE must be running and connected to the internet.
-- Only one task can be active per workspace at a time.
+- Only one task can be active per workspace at a time – but you can have as many workspaces open as you want (or your computer can handle)
 :::
 
 ## Getting Started
 
 #### Step 1: Connect Your Account
 
-Connect your Roo Code extension to Roo Code Cloud. Follow [Login](/roo-code-cloud/login#quickstart).
+Connect your Roo Code extension to Roo Code Cloud. Follow [Connect the Extension to Cloud](/roo-code-cloud/connect#quickstart).
+
+#### Step 2: Upgrade to a paid plan
 
-#### Step 2: Enable Task Sync, then Roomote Control
+Go to [Upgrade](https://app.roocode.com/billing), choose your plan and follow the instructions.
 
+#### Step 3: Ensure Task Sync and Roomote Control are enabled
+
+You should have thm on by default, but if not:
 - In the IDE: Click the cloud icon <Codicon name="cloud" /> and toggle Task Sync first, then Roomote Control in the Cloud panel.
 - In the web app: Go to Settings › User and toggle Task Sync and Roomote Control. You may also see inline “Enable …” banners on Home/Task pages.
 
@@ -61,14 +72,8 @@ If “New Task” is disabled, upgrade/enable in Settings › User › Roomote C
 
 ## Notifications
 
-Enable Push Notifications in the web app under Settings.
+You can enable Push Notifications in the web app under Settings to be notified of progress on your tasks.
 
 ## Permissions & Security
 
 - Only the user who created a task can interact with it from the browser (send messages, approve/deny).
-
-## Limitations
-
-- Requires active VS Code with Roo Code extension
-- Internet connection required for real-time sync
-- One task active per workspace at a time

docs/roo-code-cloud/task-sharing.mdx

@@ -13,17 +13,15 @@ import Codicon from '@site/src/components/Codicon';
 
 # Task Sharing
 
-Share Roo Code tasks with secure links: share with your organization (members only) or publicly (anyone with the link). Links are created by Roo Code Cloud and copied to your clipboard.
+This allows you to share Roo Code tasks (in the extension or from Cloud Agents) with secure links with whoever you choose. This allwos you to hlep others understand how you're using Roo, debug a problem or help ypour teammates learn.
 
-:::note Login Required
-You must be logged in to Roo Code Cloud to share tasks. If you haven't connected your account yet, follow the [login instructions](/roo-code-cloud/login) first.
-:::
+You can choose whether to share with your organization (Team plan only) or publicly (anyone with the link).
 
 :::note Organization Policy
 If your organization disables task sharing, the Share button is disabled and shows a tooltip indicating sharing is disabled. On the web dashboard, the Share action may also be unavailable if you don’t have permission to share that task.
 :::
 
-## Sharing from within Roo Code
+## Sharing from the Roo Code Extension
 
 1. Open the Share menu
    - In an active task, click the Share icon in the task header (right side).
@@ -40,13 +38,11 @@ If your organization disables task sharing, the Share button is disabled and sho
    - Roo generates the link and copies it to your clipboard. A brief success message appears in the UI.
    <img src="/img/task-sharing/task-sharing-12.png" alt="Share link created and copied confirmation" width="400" />
 
-## Sharing from Web UI
+## Sharing from Roo Code Cloud
 
-1. Open the web app
-   - Go to https://app.roocode.com and open the task you want to share.
+1. Go to [Roo Code Cloud](https://app.roocode.com) and open the task you want to share.
 
-2. Open the Share dialog
-   - Click the Share button to open sharing options.
+2. Click the Share button to open sharing options.
 
 3. Create and manage links
    - Choose Organization or Public, then click Create Share Link.
@@ -72,10 +68,8 @@ If your organization disables task sharing, the Share button is disabled and sho
 
 #### Data control
 - Delete share links anytime from the dashboard.
-- View recent links in the dialog (last 3 with a “+N more” summary).
-
-## What you can’t do (and why)
+- View recent links in the dialog
 
-- Track who viewed a link — viewer auditing isn’t supported.
-- Change personal account expiry — personal links always expire after 30 days.
-- Access org-only links without org membership — org links require sign-in to the same organization.
+## Caveats
+- There's no link tracking at the moment
+- Personal account links always expire after 30 days.