Home

Author: brunobergher

docs/index.md docs/index.mdxdocs/index.md renamed to docs/index.mdx

@@ -14,23 +14,37 @@ image: /img/social-share.jpg
 
 # Roo Code Docs
 
-Roo Code unleashes the full power of large language models inside VS Code. No dumbed-down assistants, no hand-holding, no limits. Just raw AI capability applied to your codebase. It costs more to run than the alternatives because it uses frontier models with actual file system access, terminal control, and multi-step workflows. If you want the best AI coding experience available, this is it.
+Roo Code is an AI-coding suite of products designed to take full advantage of the most advanced large-language models and change how you create saoftware at a fundamental level. It's unapologelically powerful and customizable, and it costs more to run than the alternatives because it uses frontier models with actual file system access, terminal control, and multi-step workflows. If you want the best AI coding experience available, this is it.
 
-## What Can Roo Code Do For YOU?
+Roo Code is available in two ways:
+- [<LucideIcon name="Puzzle" style={{ width: "14px", position: "relative", top: 4 }} /> Roo Code VS Code Extension](/getting-started/installing) works locally in your VSC Code IDE and gives you full control over your coding experience. It's great for deep or highly iterative solo developmen work. It's highly customizable and fits into your existing workflow.
+- [<LucideIcon name="Cloud" style={{ width: "14px", position: "relative", top: 4 }} /> Roo Code Cloud Agents](/roo-code-cloud/cloud-agents) are an autonomous AI development team working 24/7, as a team, collaborating with you and other co-workers on a wide range of tasks. It meets you were you do work (Slack, Github, etc) and allows for large parts of software development to happen entirely away from an IDE.
+
+The two options are highly complementary and built on the same shared foundation, achieving similarly excellent results.
+
+## What can Roo Code do for you
 
 - Generate Code from natural language descriptions and specs
-- Adapt with Modes: Code, Architect, Ask, Debug, and Custom Modes
-- Refactor & Debug existing code
-- Write & Update documentation
-- Answer Questions about your codebase
+- Refactor & debug existing code
+- Write & update documentation
+- Answer questions about your codebase
 - Automate repetitive tasks
 - Utilize MCP Servers
 
+## A mindset for success
+
+The most successful Roo users tend to embrace the following ideas:
+
+- **Leverage model agnosticism:** Roo isn't an LLM model, it needs an [LLM provider](/providers/index) to work. But it's compatible with dozens of providers and hundreds of models, so you're free to experiment, optimize and switch around, by design. No lock-ins in a world where "the best model" changes every other week.
+- **Don't skimp on tokens:** expensive state-of-the-art models with lots of tokens will almost always beat cheap models using few tokens. Pay attention to your budget, but embrace the fact that tokens are cheaper than develoer time.
+- **Trust roles:** The extension's customizable Modes (Architect, Code, etc) and the pre-defined Cloud Agent Types (Planner, Coder, etc) keep the models on track and focused on the task at hand, without stepping outside of their boundaries. Lean on them depending on the task you're working on.
+- **Be ambitious:** Roo works best the more you trust it. Out-of-the-box, the Extension will ask for your permission to everything, but as you become more comfortable and enable [Auto-Approve](/features/auto-approving-actions), you'll see it work for long periods on its own without getting stuck or making bad decisions. Once ready, throw large, complex projects at the [Orchestrator](/basic-usage/using-modes#orchestrator-mode-aka-boomerang-mode), who will coordinate tasks across Modes. In the Cloud, we handle all of this for you.
+
 ## Getting Started
 
-1. [Install Roo Code](/getting-started/installing)
-2. [Connect Your AI Provider](/getting-started/connecting-api-provider)
-3. [Try Your First Task](/getting-started/your-first-task)
+- [With the Extension](/getting-started/installing)
+- [With Roo Code Cloud](/roo-code-cloud/overview)
+
 
 ## Tutorial & Feature Videos
 
@@ -67,8 +81,8 @@ Roo Code unleashes the full power of large language models inside VS Code. No du
 
 ## Additional Resources
 
-- [YouTube Channel](https://youtube.com/@roocodeyt?feature=shared): Watch tutorials and see features in action.
 - [Discord Server](https://discord.gg/roocode): Join the community for real-time help and discussion.
 - [Reddit Community](https://www.reddit.com/r/RooCode): Share your experiences and see what others are building.
+- [YouTube Channel](https://youtube.com/@roocodeyt?feature=shared): Watch tutorials and see features in action.
 - [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues): Report bugs and track development.
-- [Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop): Have an idea? Share it with the developers.
+- [Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop): Have an idea? Share it with the team.

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

@@ -133,16 +133,4 @@ Most people will only have one agent of each type, but you may want to more tha
 - **Documentation Writer:** a tech writer that understands your code and writes actionable user-facing documentation.
 - **Translator:** translates strings with accuracy and following your brand voice.
 
-[Write us](mailto:[email protected]) if you're interested in trying them out in Beta or if you have other suggestions.
----
-
-## 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. 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.
+[Write us](mailto:[email protected]) if you're interested in trying them out in Beta or if you have other suggestions.

src/css/custom.css

@@ -2094,7 +2094,7 @@ html {
 .breadcrumbs,
 .theme-doc-breadcrumbs {
   margin-bottom: 1rem;
-  margin-left: 1.5rem;
+  margin-left: 0.7rem;
   font-size: 0.875rem;
   display: flex;
   align-items: center;