General improvements

Author: brunobergher

docs/providers/index.mdx

@@ -18,7 +18,7 @@ The Roo Code VS Code extension and Roo Code Cloud Agents are highly capable, sop
 
 Other tools are intinsically bound by design to a specific provider (like Claude Code → Anthropic Models or Codex → OpenAI models), forcing you to stick with them irrespective of how the landscape changes (which happens fast). Roo on the other hand is **model-agnostic**, allowing you to choose the model that best fits your needs, according to your budget, skill profile, codebase and more.
 
-So we support connting to a wide range of model providers, giving you flexibility in how you access AI models. Some providers work with the VS Code extension, while others are available through Roo Code Cloud Agents.
+We support connecting to a wide range of model providers, giving you flexibility in how you access AI models. Some providers work with the VS Code extension, while others are available through Roo Code Cloud Agents.
 
 Learn how to set up your provider in [the Roo Code VS Code extension here](/getting-started/connecting-api-provider).
 
@@ -37,4 +37,4 @@ Yeah, it's a lot.
 - **Want it to JustWork™?** Go with the [Roo Code Cloud Provider](/roo-code-provider/overview) for a curated selection and the easiest setup with no API keys required
 - **Want access to many models?** Try [OpenRouter](/providers/openrouter) for a single API to 100+ models
 - **Want to optimize for specific models?** Use the first part provider for each of them (Anthropic, OpenAI, etc)
-- **Looking for local/offline models?** Check out [Ollama](/providers/ollama) or [LM Studio](/providers/lmstudio)
+- **Looking for local/offline models?** Check out [Ollama](/providers/ollama) or [LM Studio](/providers/lmstudio)

docs/providers/roo-code-cloud.md

@@ -4,8 +4,6 @@ description: The easiest way to get started with AI coding. Access premium model
 keywords:
   - roo code cloud
   - roo provider
-  - grok-code-fast-1
-  - code-supernova
   - free ai models
   - easy setup
   - no api key
@@ -14,71 +12,13 @@ image: /img/social-share.jpg
 
 # Roo Code Cloud Provider
 
-**The Easiest Way to Get Started with AI Coding**
+To make it as smooth as possible to use Roo Code, which depends on a provider service for LLM inference, we've built the Roo Code Cloud Provider.
 
-Roo Code Cloud removes the complexity of setting up AI providers. Forget about API keys, credit cards, and complex configuration. Just sign in and start coding with premium models for **FREE**.
+There's no need for a separate subscription or managing API keys. It's fully integrated into our suite of products and easy to get started. It features:
 
-[Learn more about the provider here.](/roo-code-provider/overview)
+- Both free and paid models
+- Only models tested to work well with Roo
+- Paid models provided at cost, with no mark-up
+- The same pre-paid credit mechanism you'll use for Roo Code Cloud Agents
 
-## Why Choose Roo Code Cloud?
-
-- **Zero Configuration**: No API keys to manage. Just sign in with GitHub, Google, or email.
-- **No Credit Card Required**: Get started immediately without entering payment details.
-- **Free Premium Models**: Access powerful models like `grok-code-fast-1` and `code-supernova` at no cost during our promotional period.
-- **Instant Access**: Start coding in seconds.
-
-## Available Models
-
-We curate the best models for coding and offer them directly to you.
-
-### grok-code-fast-1
-*(Formerly roo/sonic)*
-- **Best for:** Fast coding, quick edits, and high-speed iterations.
-- **Speed:** Extremely Fast
-- **Context:** 262k tokens
-- **Pricing:** **FREE** (Promotional)
-
-### roo/code-supernova
-- **Best for:** Complex reasoning, multimodal tasks (images), and deep architectural planning.
-- **Capabilities:** Supports image analysis (multimodal).
-- **Context:** 200k tokens
-- **Pricing:** **FREE** (Promotional)
-
-## How to Connect
-
-1. **Sign In**: Click the account icon (<Codicon name="account" />) in the Roo Code extension sidebar and sign in. See [Connect Guide](/roo-code-cloud/connect) if needed.
-2. **Select Provider**:
-   - Open Settings (<Codicon name="gear" />).
-   - In the **API Provider** dropdown, select **Roo Code Cloud**.
-3. **Start Coding**: Choose your model and start your first task!
-
-## Pricing & Credits
-
-Roo Code Cloud operates on a [Credit System](/roo-code-cloud/billing-subscriptions).
-- **Promotional Period**: Currently, all standard usage for the models listed above is **100% FREE**.
-- **Future Pricing**: We will introduce a transparent credit-based system for usage beyond the free tier. You will always be notified before any charges apply.
-
-:::info
-Within Roo Code, free access is only through Roo Code Cloud provider. Using the [xAI provider](/providers/xai) for `grok-code-fast-1` will incur standard charges once pricing is established.
-:::
-
-## Comparison with Other Providers
-
-| Feature | Roo Code Cloud | Direct Providers (OpenAI/Anthropic/xAI) |
-| :--- | :--- | :--- |
-| **Setup** | One-click Sign In | Requires API Keys |
-| **Payment** | Free (Promo) / Credits | Credit Card / Monthly Bill |
-| **Configuration** | Automatic | Manual |
-| **Model Selection** | Curated Best-in-Class | All Available Models |
-
-## Troubleshooting
-
-**"Authentication required"**: Connect to Roo Code Cloud via the account icon.
-
-**"No session token"**: Sign out and back in to refresh your session.
-
-**Connection issues**: Check internet connection and restart VS Code if needed.
-
----
-
-[Get Started Now](/roo-code-cloud/connect)
+[Learn more and how to get started <LucideIcon name="ArrowRight" />](/roo-code-provider/overview)

docs/roo-code-cloud/github-integration.mdx

@@ -12,11 +12,18 @@ image: /img/social-share.jpg
 
 # GitHub Integration
 
-Roo Code Cloud integrates directly with GitHub to bring your autonomous Cloud Agent team into your pull request workflow. By installing the Roo Code GitHub App, you can enable agents to automatically review code and fix issues without leaving GitHub.
-
+Roo Code Cloud integrates directly with GitHub to bring your autonomous Cloud Agent team into your pull request workflow. By installing the Roo Code GitHub App, you can enable agents to create branches, automatically review code and fix issues.
 
 ---
 
+## Integration Touchpoints
+
+Here are the ways [Cloud Agents](/roo-code-cloud/cloud-agents) integrate with Github:
+- **Code creation:** the Coder agent delivers its work via git. When you ask it to create/change something, it will make changes in its container enviornment, commit them locally, push to the remote repository and create a PR describing it all. You can change its settings to create a draft (not regular) PR, or to just push to the remote branch, without creating a PR.
+- **Code review:** the Reviewer agent delivers its work via Github PR comments. It will automatically review newly created PRs (including by the Coder!) in the repositories where it's enabled, by adding comments. It will also review subsequent commits which get pushed to that branch. You can control criteria for what PRs get reviewd in the its settings.
+- **Code fixes:** the Fixer agent delivers its work via pushes to Github branches (and comments). When you invoke it from a PR (see below) it will read through comments (made by humans or Cloud Agents) and implement proper fixes, taking any additional instructions you give it into consideration. It will do so by checking out the PR branch in its environment, commiting changes and pushing them to the branch (and leaving a comment when its done so you can know).
+
+
 ## Setting Up
 
 You'll be prompted to connect to Github when first creating your Cloud Agent team. If you haven't done that yet, [do it now](https://app.roocode.com/cloud-agents/setup) and make sure to create at least a PR Reviewer and PR Fixer agent.

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

@@ -24,16 +24,7 @@ It creates a bidirectional connection between your local VS Code extension and R
 
 Think of it as a halfway point between autonomous [Cloud Agents](/roo-code-cloud/cloud-agents) and overseeing Roo in the extension.
 
-## Key Features
-
-- **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
-- Single active task per workspace is enforced
-
-:::note Requirements
-- A paid plan
+:::note Things to keep in mind
 - Task Sync must be enabled
 - Remote Control must be enabled
 - Your IDE must be running and connected to the internet
@@ -44,30 +35,21 @@ Think of it as a halfway point between autonomous [Cloud Agents](/roo-code-cloud
 
 ## Getting Started
 
-#### Step 1: Connect Your Account
-
-Connect your Roo Code extension to Roo Code Cloud. Follow [Connect the Extension to Cloud](/roo-code-cloud/connect#quickstart) or [Login/Signup](/roo-code-cloud/login).
-
-#### Step 2: Upgrade to a paid plan
-
-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
+1. Connect your Roo Code extension to Roo Code Cloud. Follow [Connect the Extension to Cloud](/roo-code-cloud/connect#quickstart) or [Login/Signup](/roo-code-cloud/login).
+2. Ensure Task Sync and Roomote Control are enabled:
+    - In the IDE: Click the cloud icon <Codicon name="cloud" /> and toggle Task Sync first, then Roomote Control in the Cloud panel.
+        <img src="/img/roomote-control/roomote-control-ext.png" alt="How your settings should look" width="340" />
+    - 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.
 
-You should have them 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.
-    <img src="/img/roomote-control/roomote-control-ext.png" alt="How your settings should look" width="340" />
-- 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.
+3. Your workspace(s) should appear in the sidebar in the web app.
 
-#### Step 4: Start a Remote Task
+### Creating a task
 
-When connected and enabled:
-1. Your VS Code workspace(s) appear in the web app.
-2. Click New Task on a connected workspace card.
-3. Enter a task description and click Start.
-4. Watch progress and interact in real time.
+1. Click New Task on a connected workspace card in the web app.
+2. Enter a task description and click Start.
+3. Watch progress and interact in real time.
 
-If "New Task" is disabled, upgrade/enable in Settings › User › Roomote Control.
+If "New Task" is disabled, enable in Settings › User › Roomote Control.
 
 ## Notifications
 

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

@@ -20,9 +20,11 @@ It creates a live, one-way stream of your task messages and status from your loc
 - Check when a task completes without sitting in front of your IDE
 - Review your cloud task history anytime
 
-<img src="/img/task-sync/task-sync.png" alt="Roo Code Cloud home showing connected workspaces and tasks" width="800" />
+<img src="/img/task-sync/task-sync.png" alt="Roo Code Cloud home showing connected workspaces and tasks" width="600" />
 
-Task Sync is optimized for mobile. Check in on progress between meetings, during a build, or while a model is running — without being stuck at your desk.
+:::info IDE <LucideIcon name="ArrowRight" style={{ position: "relative", top: "3px" }} /> Cloud
+Keep in mind Task Sync sends tasks from your IDE to Roo Code Cloud, but not vice-versa. For example, it doesn't sync tasks across devices at the moment.
+:::
 
 ---
 
@@ -38,7 +40,6 @@ Task Sync is optimized for mobile. Check in on progress between meetings, during
 ## Upgrading to Remote Control
 
 If you also want to continue tasks remotely (approve actions, respond to prompts, start/stop tasks), enable [Roomote Control](/roo-code-cloud/roomote-control).
-See [Billing & Subscriptions](/roo-code-cloud/billing-subscriptions) for plan details.
 
 ## Limitations