Getting ready for 4.0

Author: hannesrudolph

docs/roo-code-cloud/analytics.mdx

@@ -0,0 +1,31 @@
+---
+description: Track usage and credits in Roo Code Cloud. View tokens, tasks, estimated cost, and credit consumption over time; learn where to check spend for Cloud Agents.
+keywords:
+  - Roo Code Cloud
+  - analytics
+  - usage
+  - tokens
+  - credits
+  - cost
+image: /img/social-share.jpg
+redirect_from:
+  - /roo-code-cloud/dashboard
+  - /roo-code-cloud/dashboard/
+  - /roo-code-cloud/dashboard#usage-analytics-page
+---
+
+# Analytics
+
+Analytics lets you track tokens, tasks, estimated cost, and Cloud Agent credits at a glance.
+
+## Access
+
+- Open the Analytics tab in the web app, or go directly https://app.roocode.com/usage
+
+## 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.
+

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

@@ -1,89 +1,121 @@
 ---
-description: Manage your Roo Code Cloud Pro subscription to unlock premium features including Roomote Control for remote task management.
+description: "Manage Roo Code Cloud plans (Individual Pro and Teams): trials, billing, cancellations, and credits. Pricing and trial length are shown in-app to prevent drift."
 keywords:
   - billing
-  - subscription
+  - subscriptions
   - pro plan
+  - team plan
   - payment
   - stripe
   - pricing
 image: /img/social-share.jpg
 ---
 
 import Codicon from '@site/src/components/Codicon';
-
-# Billing & Subscriptions
-
-Roo Code Cloud offers a Pro subscription with a free 14-day trial, then $20/month, unlocking premium features including Roomote Control.
-
-## Subscription Plan
-
-### Pro Plan ($20/month)
-Free 14-day trial, then $20/month. Cancel anytime.
-
-- **Roomote Control**
-  - **Chat Interface** - Interact with the chatbox just as though you were in your IDE (includes message queuing, attaching images, changing modes, switching providers, and all standard chat features)
-  - **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
-- Priority support
-- Monthly auto-renewal
-
-
-## Getting Started with Pro
-
-### Step 1: Access Upgrade
-
-<img src="/img/billing-subscriptions/billing-subscriptions-1.png" alt="Upgrade page showing Start Trial for Pro" width="800" />
-
-Open the Upgrade page (for non-subscribers):
-- Go to [app.roocode.com/billing](https://app.roocode.com/billing)
-- Or click **Upgrade** from your dashboard
-
-
-### Step 2: Subscribe to Pro
-
-Click **Start Trial** to open Stripe checkout, complete payment, and begin your 14‑day trial (then $20/month).
-
-### Step 3: Confirmation
-
-After checkout:
-- Your plan shows as **Active**
-- Roomote Control is enabled immediately
-- You'll receive a confirmation email
-Manage your plan any time from the Billing page.
-
-<img src="/img/billing-subscriptions/billing-subscriptions-2.png" alt="Billing page with active Pro plan and Manage Subscriptions" width="800" />
+import PlanBox from '@site/src/components/PlanBox';
+
+# Subscriptions & Billing
+
+Roo Code Cloud offers three subscriptions: Free, Pro and Teams.
+
+
+
+<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.
 
 ## Managing Your Subscription
 
-### Subscription Portal
-
-Click **Manage Subscription** to open Stripe's portal for payment methods, invoices, and billing details.
-
-
-### Cancellation
-
-To cancel your Pro subscription:
+- Select Manage Subscription to open Stripe’s portal for payment methods, invoices, and billing details.
+- To cancel:
+  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.
 
-1. Go to your billing page
-2. Click **Manage Subscription**
-3. Select **Cancel Plan** in the Stripe portal
-4. Confirm cancellation
+## Cloud Agents & Credits
 
-:::note
-During the 14-day trial, cancel before the trial ends to avoid the first charge. After you are billed, Pro features remain active until the end of your current billing period. You can resubscribe at any time.
-:::
+- 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)
 
 ## Payment & Security
 
-### Payment Processing
-- Payments are securely processed through **Stripe**
+#### Payment Processing
+- Payments are securely processed through Stripe
 - We never store your credit card information
-- PCI-compliant payment handling
-- Supports all major credit cards
+- PCI‑compliant payment handling
 
-### Billing Cycle
+#### Billing Cycle
 - Monthly billing on the same date each month
 - Automatic renewal unless canceled
 - Immediate access upon payment

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

@@ -0,0 +1,87 @@
+---
+description: Run Roo in the cloud without your IDE. Cloud Agents keep tasks going headlessly, let teammates monitor via links/QR, and honor org policies. Runtime is billed in credits; inference uses your own model keys.
+keywords:
+  - cloud agents
+  - hosted execution
+  - credits
+  - runtime billing
+  - BYO keys
+  - task sharing
+  - remote control
+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.
+
+## What Roo Code Cloud Agents are
+
+Hosted, headless Roo instances that:
+- Run tasks in cloud containers independent of your local IDE
+- 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)
+
+## 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
+
+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.
+
+**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
+
+**Automation**: Manual-only. No webhook triggers; jobs start when you click Run or submit a task from the app.
+</details>
+
+<details>
+<summary><strong>PR Rooviewer</strong></summary>
+
+Automatically reviews GitHub pull requests using your model, posts feedback, and tracks costs—triggered by webhooks or run on demand.
+
+**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
+
+**Automation**: Agent responds to GitHub webhook events (PR opened, ready for review, new commits). Eligibility depends on repo selection, author filter, and draft settings.
+
+</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.
+
+- 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.