You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit d5940de
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: AGENTS.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This file provides guidance to agents when working with code in this repository.
4
4
5
5
Non-obvious, project-specific rules:
6
6
7
-
- Start/build preload dotenv; analytics plugin is enabled only when POSTHOG_API_KEY is set. Use .env based on [.env.example](.env.example). CI injects it in [.github/workflows/docusaurus-build.yml](.github/workflows/docusaurus-build.yml). See [package.json](package.json) and [docusaurus.config.ts](docusaurus.config.ts).
7
+
- Start/build preload dotenv. No environment variables are required by default; use [.env.example](.env.example) only when adding local-only settings. See [package.json](package.json) and [docusaurus.config.ts](docusaurus.config.ts).
8
8
- Use Node 20 locally to match CI; engines allow >=18 but CI runs 20.
9
9
- Linting targets only /src; docs content is not linted. Use "pnpm run lint:unused" to enforce unused import removal. Type checking uses "tsc" only (no emit); [tsconfig.json](tsconfig.json) is editor-focused.
10
10
- When moving/renaming docs, you must add an explicit redirect in [docusaurus.config.ts](docusaurus.config.ts) under plugin-client-redirects. This is required by [.roorules](.roorules).
- Navigation/footer links are centralized in [src/constants.ts](src/constants.ts) and consumed by [docusaurus.config.ts](docusaurus.config.ts). Update constants rather than hardcoding URLs.
17
17
- Legacy [Rakefile](Rakefile) is unrelated (Jekyll). Do not use it; all builds run through Docusaurus scripts.
18
18
- For structural/formatting research, use Context7 MCP (ID "/facebook/docusaurus") via [.roo/mcp.json](.roo/mcp.json); see [.roorules](.roorules).
19
-
- CI runs build and check-types (no lint). Run lint locally to catch issues CI won't.
19
+
- CI runs build and check-types (no lint). Run lint locally to catch issues CI won't.
Copy file name to clipboardExpand all lines: docs/faq.md
+4-7Lines changed: 4 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ This page answers some common questions about Roo Code.
22
22
23
23
### What is Roo Code?
24
24
25
-
Roo Code is an AI-powered suite of coding products designed to take full advantage of the most advanced large-language models.
25
+
Roo Code is an open-source AI coding agent for VS Code designed to take full advantage of advanced large-language models.
26
26
27
27
### How does Roo Code work?
28
28
@@ -33,7 +33,7 @@ Roo Code uses large language models (LLMs) to understand your requests and trans
33
33
- Perform web browsing (if enabled)
34
34
- Use external tools via the Model Context Protocol (MCP)
35
35
36
-
You interact with Roo Code through either a chat interface (in the Extension) or through different channels (in the Cloud).
36
+
You interact with Roo Code through a chat interface in the extension.
37
37
38
38
### What can Roo Code do?
39
39
@@ -50,10 +50,9 @@ Roo Code can help with a variety of coding tasks, including:
50
50
51
51
### Is Roo Code free to use?
52
52
53
-
The Roo Code Extension is free and [open-source](https://github.com/RooCodeInc/Roo-Code/).
54
-
The Roo Code Cloud platform is also free, but some functionality is paid.
53
+
The Roo Code extension is free and [open-source](https://github.com/RooCodeInc/Roo-Code/).
55
54
56
-
In both cases, Roo Code relies on external LLM inference providers (like [Anthropic](providers/anthropic), [OpenAI](providers/openai), [OpenRouter](providers/openrouter), [Requesty](providers/requesty), etc.) for its AI capabilities. We also offer [Roo Code Router](/roo-code-router/overview) as an alternative.
55
+
Roo Code relies on external LLM inference providers (like [Anthropic](providers/anthropic), [OpenAI](providers/openai), [OpenRouter](providers/openrouter), [Requesty](providers/requesty), etc.) for its AI capabilities.
57
56
These providers typically charge for API usage based on the number of tokens processed. You will need to create an account and obtain an API key from your chosen provider. Learn more [about providers and how to set them up](/providers/) for details.
58
57
59
58
### What are the risks of using Roo Code?
@@ -80,8 +79,6 @@ See the [full list here](/providers/).
80
79
81
80
Each API provider has its own process for obtaining an API key. See the [Setting Up Your First AI Provider](/getting-started/connecting-api-provider) for links to the relevant documentation for each provider.
82
81
83
-
If you use the [Roo Code Router](/roo-code-router/overview), you don't need an API key.
84
-
85
82
### Can I use Roo Code with local models?
86
83
Yes, Roo Code supports running models locally using [Ollama](/providers/ollama) and [LM Studio](/providers/lmstudio). See [Using Local Models](/advanced-usage/local-models) for instructions.
Copy file name to clipboardExpand all lines: docs/getting-started/connecting-api-provider.md
+3-6Lines changed: 3 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,9 +18,7 @@ Roo Code needs an inference provider to access the LLM models that make it work.
18
18
19
19
A great model to start is **Claude Sonnet 4.5**, which offers a lot of power at a reasonable price point. To get it going, choose a provider:
20
20
21
-
-**Roo Code Router (Recommended):** the easiest way to access multiple providers tested with Roo Code. No API needed. To get started, just choose Roo Code Router as a provider and follow instructions. [Learn more about it](/roo-code-router/overview).
22
-
23
-
-**OpenRouter:** Provides access to multiple AI models from different labs through a single API key. Great for flexibility and getting started reasonably fast. To get an API key, [follow these instructions <LucideIconname="ArrowRight" />](/providers/openrouter#getting-an-api-key)
21
+
-**OpenRouter (Recommended):** Provides access to multiple AI models from different labs through a single API key. Great for flexibility and getting started reasonably fast. To get an API key, [follow these instructions <LucideIconname="ArrowRight" />](/providers/openrouter#getting-an-api-key)
24
22
25
23
-**Anthropic:** Direct access to the Claude family of models. Requires API access approval and may have [rate limits depending on your tier](https://docs.anthropic.com/en/api/rate-limits#requirements-to-advance-tier). To get an API key, [follow these instructions <LucideIconname="ArrowRight" />](/providers/anthropic#getting-an-api-key)
26
24
@@ -38,8 +36,7 @@ You can choose other models, but that introduces complexity. Different models va
38
36
39
37
1. Open the Roo Code panel by clicking the Roo Code icon (<KangarooIcon />) in the VS Code Activity Bar
40
38
2. In the welcome screen, choose your LLM provider.
41
-
3. If you choose the Roo Code Router, just connect your account and choose `anthropic/claude-sonnet-4-5` from the dropdown. You're set.
42
-
4. If you chose another provider, paste the API key you copied from it into the right field and continue
43
-
5. Select your model (it should be called `claude-sonnet-4-5` or `anthropic/claude-sonnet-4-5`) and complete the process.
39
+
3. Paste the API key you copied from your provider into the right field and continue.
40
+
4. Select your model (it should be called `claude-sonnet-4-5` or `anthropic/claude-sonnet-4-5`) and complete the process.
Copy file name to clipboardExpand all lines: docs/index.mdx
+6-14Lines changed: 6 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,19 +13,11 @@ keywords:
13
13
14
14
# Roo Code Docs
15
15
16
-
:::danger Sunsetting Roo Code on May 15, 2026
17
-
**All Roo Code products (Extension, Cloud, and Router) will be shut down on May 15, 2026.** We will refund any unused balances. For alternatives, we recommend [Cline](https://github.com/cline/cline) (open-source extension) or [roomote.dev](https://roomote.dev) (our next project). For billing questions after May 15, contact [billing@roocode.com](mailto:billing@roocode.com). [Read the full details](/sunset).
18
-
:::
19
-
20
-
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 software at a fundamental level. It's unapologetically 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.
16
+
Roo Code is an open-source AI coding agent for VS Code designed to take full advantage of advanced large-language models and change how you create software at a fundamental level. It's powerful, customizable, and model-agnostic, with actual file system access, terminal control, and multi-step workflows.
21
17
22
18
Roo's approach is to trade tokens for quality. If you want the best and most effective AI coding experience available, this is it.
23
19
24
-
Roo Code is available in two ways:
25
-
-[<LucideIconname="Puzzle"style={{ width: "14px", display: "inline-block", verticalAlign: "middle" }} /> Roo Code VS Code Extension](/getting-started/installing) works locally in your VS Code IDE and gives you full control over your coding experience. It's great for deep or highly iterative solo development work. It's highly customizable and fits into your existing workflow.
26
-
-[<LucideIconname="Cloud"style={{ width: "14px", display: "inline-block", verticalAlign: "middle" }} /> 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 where you do work (Slack, Github, etc) and allows for large parts of software development to happen entirely away from an IDE.
27
-
28
-
The two options are highly complementary and built on the same shared foundation, achieving similarly excellent results.
20
+
The Roo Code VS Code extension works locally in your IDE and gives you full control over your coding experience. It's great for deep or highly iterative development work, and it fits into your existing workflow.
29
21
30
22
## What can Roo Code do for you
31
23
@@ -42,13 +34,13 @@ The most successful Roo users tend to embrace the following ideas:
42
34
43
35
-**Leverage model agnosticism:** Roo isn't an LLM model, it needs an [LLM provider](/providers) 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.
44
36
-**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 developer time.
45
-
-**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.
46
-
-**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.
37
+
-**Trust roles:** The extension's customizable Modes (Architect, Code, 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.
38
+
-**Be ambitious:** Roo works best the more you trust it. Out-of-the-box, the extension will ask for your permission to do 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.
47
39
48
40
## Getting Started
49
41
50
-
-[With the Extension](/getting-started/installing)
51
-
-[With Roo Code Cloud](/roo-code-cloud/overview)
42
+
-[Install the Extension](/getting-started/installing)
43
+
-[Connect an LLM Provider](/getting-started/connecting-api-provider)
0 commit comments