First pass at revamped cloud docs

Author: brunobergher

docs/providers/roo-code-cloud.md

@@ -1,92 +1,68 @@
 ---
 sidebar_label: Roo Code Cloud
-description: Access free AI models including grok-code-fast-1 and code-supernova through Roo Code Cloud. No API keys or payment required during the promotional period.
+description: The easiest way to get started with AI coding. Access premium models like grok-code-fast-1 and code-supernova for free with zero configuration.
 keywords:
   - roo code cloud
   - roo provider
   - grok-code-fast-1
   - code-supernova
-  - sonic model
   - free ai models
-  - cloud authentication
+  - easy setup
   - no api key
 image: /img/social-share.jpg
 ---
 
-# Roo Code Cloud Provider - FREE AI Models
+# Roo Code Cloud Provider
 
-Access **FREE** AI models through Roo Code Cloud authentication, including "grok-code-fast-1" (formerly "roo/sonic") and the new "code-supernova" model. **No API keys, no credit cards, no usage costs** during the promotional period.
+**The Easiest Way to Get Started with AI Coding**
 
-:::info Model Name Update
-The "roo/sonic" model is being renamed to **"grok-code-fast-1"** (officially "Grok Code Fast"). The model will be updated by **August 29th**. This is the same powerful coding model, just with its official xAI name. The model remains **free** when accessed through Roo Code Cloud during the promotional period.
+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**.
 
-**Important for Roo Code users:** Within Roo Code, this model is only free through Roo Code Cloud. Using it directly through the [xAI provider](/providers/xai) in Roo Code will incur standard charges once pricing is established.
-:::
+## Why Choose Roo Code Cloud?
 
-:::note
-- Requires Roo Code Cloud account
-- Internet connection required
-- Prompts and completions are logged for model improvement
-- Available during promotional period only
-- Within Roo Code, free access is through Roo Code Cloud provider
-:::
+- **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.
 
----
-
-## Setup
-
-1. **Connect to Roo Code Cloud:**
-   - Click the account icon (<Codicon name="account" />) in Roo Code panel
-   - Sign in with GitHub, Google, or email
-   - See [Login Guide](/roo-code-cloud/login) if needed
+## Available Models
 
-2. **Select Provider:**
-   - Open Roo Code Settings (<Codicon name="gear" />)
-   - Choose "Roo Code Cloud" from the API Provider dropdown
-   - Select your preferred model:
-     - "grok-code-fast-1" (may still show as "Sonic" until August 29th)
-     - "roo/code-supernova" (new stealth model)
-
----
+We curate the best models for coding and offer them directly to you.
 
-## Models
+### 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)
 
-### grok-code-fast-1 (formerly roo/sonic)
-- Official Name: Grok Code Fast
-- Context Window: 262,144 tokens
-- Max Output: 16,384 tokens
-- Image Support: No
-- Optimized for: Coding tasks, checkpoint and deployment
-- **Pricing:** Free during promotional period through Roo Code Cloud
+### 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)
 
-### roo/code-supernova - NEW & FREE
-- Context Window: 200,000 tokens
-- Max Output: 16,384 tokens
-- Image Support: **Yes** - supports image inputs for multimodal tasks
-- Prompt Caching: Yes
-- Optimized for: Versatile agentic coding tasks with multimodal capabilities
-- **Pricing:** **100% FREE** during promotional period through Roo Code Cloud
-- **No limits, no restrictions** - use as much as you need at zero cost
+## How to Connect
 
-:::tip Why Use Roo Code Cloud? It's FREE!
-Within Roo Code, both `grok-code-fast-1` and `roo/code-supernova` are **100% FREE** when accessed through Roo Code Cloud. No hidden costs, no surprises - just powerful AI models at zero cost during the promotional period.
+1. **Sign In**: Click the account icon (<Codicon name="account" />) in the Roo Code extension sidebar and sign in.
+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!
 
-**Important:** Using the [xAI provider](/providers/xai) directly in Roo Code will incur standard rates once pricing is established. Stick with Roo Code Cloud for **FREE access**.
-:::
-
-:::info Model Selection - Both FREE!
-- Choose **grok-code-fast-1** (FREE) for maximum speed and context window
-- Choose **roo/code-supernova** (FREE) when you need image support or multimodal capabilities
-
-Both models are **completely free** through Roo Code Cloud - use whichever fits your needs!
-:::
-
----
+## Pricing & Credits
 
-## Troubleshooting
+Roo Code Cloud operates on a [Credit System](/roo-code-cloud/credits).
+- **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.
 
-**"Authentication required"**: Connect to Roo Code Cloud via the account icon.
+## Comparison with Other Providers
 
-**"No session token"**: Sign out and back in to refresh your session.
+| 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 |
 
-**Connection issues**: Check internet connection and restart VS Code if needed.
+[Get Started Now](/roo-code-cloud/login)

docs/roo-code-cloud/agent-workflows.mdx

@@ -0,0 +1,74 @@
+---
+description: Real-world recipes and workflows for getting the most out of Roo Code Cloud autonomous agents.
+keywords:
+  - agent workflows
+  - automation recipes
+  - refactoring
+  - testing
+  - documentation
+  - bug triage
+image: /img/social-share.jpg
+---
+
+# Autonomous Agent Workflows
+
+This guide provides "recipes" for common high-value workflows using Roo Code Cloud agents.
+
+## 🌙 The Overnight Refactor
+
+Use the **Coder Agent** to handle time-consuming refactoring tasks while you sleep.
+
+**Goal**: Convert a legacy JavaScript module to TypeScript.
+
+1. **Preparation**: Create a new branch `refactor/legacy-module`.
+2. **Trigger**: In Slack or the Web Interface, summon the Coder Agent.
+3. **Prompt**:
+   > "Checkout branch `refactor/legacy-module`. Convert the files in `src/legacy/` to TypeScript. Fix any type errors. Ensure all existing tests pass. Do not change the runtime logic."
+4. **Result**: By morning, you have a PR waiting for review with the heavy lifting done.
+
+## 🛡️ The PR Guardian
+
+Configure the **PR Reviewer** and **PR Fixer** to act as a first line of defense.
+
+**Goal**: Ensure no code style violations or simple bugs reach human review.
+
+1. **Setup**: Enable **PR Reviewer** for your repository in the Dashboard.
+2. **Workflow**:
+   - Developer opens a PR.
+   - **PR Reviewer** scans it and finds a missing error handler.
+   - It posts a comment: *"Line 52: Potential unhandled promise rejection here."*
+   - Developer (or the PR Reviewer itself, if configured) triggers the **PR Fixer** via `@roomote fix this`.
+   - **PR Fixer** pushes the correction.
+3. **Benefit**: Human reviewers focus on architecture and logic, not nitpicks.
+
+## 🐛 Automated Bug Triage
+
+Use the **Explainer Agent** (or a specialized Triage workflow) to diagnose issues.
+
+**Goal**: Quickly understand a new bug report.
+
+1. **Trigger**: A new issue comes in: *"Login fails with 500 error when username has emoji"*.
+2. **Action**: Ask the agent in Slack:
+   > "Check the `login` function in `auth.controller.ts`. Trace how it handles special characters in usernames. specific to emoji inputs."
+3. **Result**: The agent provides a trace explaining exactly where the regex validation is failing, saving you 30 minutes of investigation.
+
+## 📚 Documentation Sync
+
+Keep your docs up to date with code changes.
+
+**Goal**: Update API documentation after a breaking change.
+
+1. **Trigger**: After merging a PR that changes an API endpoint.
+2. **Prompt**:
+   > "I just updated the `/users` endpoint to require a `tenantId`. Update the Swagger/OpenAPI spec in `docs/api.yaml` and the markdown guide in `docs/guides/users.md` to reflect this change."
+3. **Result**: A documentation-only PR is created, ensuring your docs never rot.
+
+## 🧪 Test Generation
+
+Increase coverage without the tedium.
+
+**Goal**: Add unit tests to a legacy component.
+
+1. **Prompt**:
+   > "Analyze `src/utils/complex-calc.ts`. It currently has 0% coverage. Write a comprehensive test suite in Jest covering all edge cases, including negative numbers and null inputs."
+2. **Result**: A new test file `src/utils/complex-calc.test.ts` is created with passing tests.

docs/roo-code-cloud/analytics.mdx

@@ -0,0 +1,51 @@
+---
+description: Monitor token usage, track costs, and analyze agent performance with Roo Code Cloud Analytics.
+keywords:
+  - analytics
+  - token usage
+  - cost tracking
+  - agent performance
+  - roi
+  - team insights
+image: /img/social-share.jpg
+---
+
+# Analytics & Insights
+
+Roo Code Cloud provides comprehensive analytics to help you understand how your team is using AI, optimize costs, and measure productivity.
+
+<img src="/img/analytics/dashboard-overview.png" alt="Analytics Dashboard" width="800" />
+
+## Usage Tracking
+
+### Cross-Provider Visibility
+See all your AI consumption in one place, regardless of the provider.
+- **Roo Code Cloud**: Track usage of hosted models.
+- **OpenAI / Anthropic**: If you use your own API keys in the local extension, Roo Code Cloud aggregates these logs (if enabled) to give you a unified view of your AI spend.
+- **Local Models**: Track usage of local LLMs (Ollama, LM Studio) to understand offloaded costs.
+
+### Cost Breakdown
+- **Daily/Monthly Spend**: View cost trends over time.
+- **Cost by Model**: Identify which models are driving your expenses.
+- **Cost by Agent**: See how much each autonomous agent type (Coder vs. Planner) costs to run.
+
+## Performance Metrics
+
+Understand the ROI of your autonomous agents.
+
+- **Task Success Rate**: Percentage of agent tasks that completed successfully without human intervention.
+- **Tasks per Day**: Volume of work being offloaded to the cloud.
+- **Time Saved**: Estimated engineering hours saved based on agent task duration and complexity.
+
+## Team Insights
+
+For organizations, the **Team Dashboard** provides high-level visibility.
+
+- **Top Users**: Identify who in your team is getting the most value out of AI.
+- **Adoption Rate**: Track how many team members are using cloud agents vs. local extension.
+- **Shared Credits**: Monitor the burn rate of your team's shared credit pool.
+
+## Export & Reporting
+
+- **CSV Export**: Download raw usage data for custom analysis.
+- **Budget Alerts**: Set up email notifications when spending exceeds defined thresholds.

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

@@ -0,0 +1,104 @@
+---
+description: Comprehensive guide to Roo Code Cloud's autonomous agents - specialized AI workers that plan, code, review, and fix software independently.
+keywords:
+  - Cloud Agents
+  - Autonomous Agents
+  - PR Reviewer
+  - PR Fixer
+  - Coder Agent
+  - Planner Agent
+  - Explainer Agent
+  - AI orchestration
+image: /img/social-share.jpg
+---
+
+# Cloud Agents
+
+Cloud Agents are specialized, autonomous AI workers that run in the cloud. Unlike the standard Roo Code extension that runs locally in your editor, Cloud Agents are designed to perform specific roles independently, 24/7, without requiring your local machine to be active.
+
+<img src="/img/cloud-agents/overview.png" alt="Cloud Agents Overview" width="800" />
+
+## Available Agents
+
+### 🏗️ Planner Agent
+**Role:** Architect & Strategist  
+**Mode:** Architect  
+**Availability:** ✅ Available
+
+The Planner agent maps out implementation plans and navigates complex technical decisions. It's designed to take a high-level idea or a Product Requirement Document (PRD) and break it down into a thorough, step-by-step implementation plan.
+
+- **Best for:** New feature planning, system architecture design, complex refactoring strategies.
+- **Onboarding Tip:** "Enter an idea (or paste a PRD) and get a thorough implementation plan."
+- **Recommended Models:** High-reasoning models like `anthropic/claude-opus-4.5` or `openai/gpt-5.1`.
+
+### 👨‍💻 Coder Agent
+**Role:** Software Engineer  
+**Mode:** Code  
+**Availability:** ✅ Available
+
+The Coder agent writes code, creates pull requests, and implements features. It is the workhorse of the platform, capable of handling end-to-end coding tasks.
+
+- **Best for:** Building features, fixing bugs, refactoring components, writing tests.
+- **Onboarding Tip:** "Build a feature, fix an issue, refactor a component."
+- **Capabilities:** Can create draft PRs or push directly depending on settings.
+
+### 🔍 PR Reviewer Agent
+**Role:** Code Reviewer  
+**Mode:** Code  
+**Availability:** ✅ Available
+
+The PR Reviewer agent automatically provides comprehensive code reviews with actionable comments. It can monitor your repositories and review incoming Pull Requests.
+
+- **Best for:** Automated code quality checks, catching bugs early, enforcing coding standards.
+- **Onboarding Tip:** "Give it a PR, get thorough and actionable comments back."
+- **Settings:**
+    - `authorReviewMode`: Choose to review 'all', 'specific', or 'none' (no automatic triggers).
+    - `approvePr`: Can optionally approve PRs if no issues are found.
+    - `reviewDraftPrs`: Option to review draft PRs.
+
+### 🛠️ PR Fixer Agent
+**Role:** Bug Fixer  
+**Mode:** Code  
+**Availability:** ✅ Available
+
+The PR Fixer agent is specialized in resolving issues identified in Pull Requests. It listens for feedback and autonomously implements fixes.
+
+- **Best for:** Resolving PR comments, fixing CI/CD failures, addressing review feedback.
+- **Onboarding Tip:** "Give it a PR with comments and get it solved."
+- **Trigger:** Often triggered via `@roomote` mentions in PR comments.
+
+### 🧠 Explainer Agent
+**Role:** Technical Educator  
+**Mode:** Ask  
+**Availability:** ✅ Available
+
+The Explainer agent explains code, concepts, and technical documentation. It helps you understand complex parts of a codebase without needing to read every line.
+
+- **Best for:** Onboarding to a new codebase, understanding legacy code, debugging conceptual issues.
+- **Onboarding Tip:** "Understand the source of a bug or how a part of the code works."
+
+## Upcoming Agents
+
+We are constantly expanding our agent fleet. Here are agents currently in development or preview:
+
+| Agent | Role | Status | Description |
+| :--- | :--- | :--- | :--- |
+| **Improver** | Rule Optimizer | 🚧 Preview | Analyzes agent feedback and PR reviews to maintain and improve rules files. |
+| **Documentation Writer** | Tech Writer | ⏳ Coming Soon | Understands your code and writes actionable user-facing documentation. |
+| **Security Auditor** | Security Expert | ⏳ Coming Soon | Conducts security audits and identifies vulnerabilities. |
+| **Translator** | Localization | ⏳ Coming Soon | Translates strings with accuracy and following your brand voice. |
+
+## How Cloud Agents Work
+
+1. **Triggering**: Agents can be triggered manually via the [Web Interface](/roo-code-cloud/web-interface), or automatically via [GitHub Integrations](/roo-code-cloud/github-integration) (e.g., new PR opened) and [Slack Integrations](/roo-code-cloud/slack-integration) (e.g., `@Roomote` mention).
+2. **Execution**: The agent spins up a secure, isolated cloud environment to perform its task. It clones your repository, analyzes the context, and executes the required actions.
+3. **Completion**: Once the task is done, the agent reports back—creating a PR, posting a comment, or sending a Slack message.
+4. **Handoff**: You can intervene at any time using [Roomote Control](/roo-code-cloud/roomote-control) to take manual control of the session.
+
+## Credits & Usage
+
+Cloud Agents consume **Cloud Credits**. Usage is measured based on the model used and the duration of the task.
+- **Free Tier:** Includes access to free models for standard tasks.
+- **Pro Tier:** Unlocks concurrent agent execution and priority queueing.
+
+[Learn more about Cloud Credits](/roo-code-cloud/credits)