Roo Code — AI Coding Team Inside VS Code
Open-source AI coding extension with custom agent modes, MCP support, and cloud agents. Fork of Cline with 22K+ stars.
What it is
Roo Code is a free, open-source AI coding extension for VS Code. Originally forked from Cline, it has grown into a standalone product with custom agent modes, multi-model support, and MCP (Model Context Protocol) integration. It provides five built-in personas -- Code, Architect, Ask, Debug, and Custom -- each with scoped tool permissions so the right agent handles the right task.
It targets developers who want AI assistance directly in their editor without switching to a separate tool. Roo Code supports OpenAI, Anthropic Claude, local LLMs, and other providers through a unified configuration.
How it saves time or tokens
Each agent mode has scoped tool permissions, which means the Code agent can edit files but the Ask agent only reads them. This reduces unnecessary token consumption by preventing agents from running expensive tool calls when they only need to answer a question. The Custom mode lets you define exactly which tools an agent can access for specialized workflows.
MCP support means Roo Code can connect to external data sources (databases, APIs, documentation) without including all that context in the prompt, further reducing token usage.
How to use
- Install from the VS Code marketplace:
code --install-extension RooVeterinaryInc.roo-cline
- Open the Roo Code sidebar and configure your preferred AI provider (OpenAI, Anthropic, local LLM endpoint).
- Select an agent mode (Code, Architect, Ask, Debug, or Custom) and start a conversation about your codebase.
Example
Using Roo Code's Code agent to add error handling:
[Code Mode] Add try-catch error handling to the database
connection function in src/db.ts. Log errors with the
existing Winston logger and return a typed error result
instead of throwing.
The Code agent reads the file, understands the existing patterns, generates the changes, and applies them with your approval.
Related on TokRepo
- Coding Tools -- AI-powered development tools for code generation and review
- Prompt Library -- Reusable prompts that work with AI coding assistants
Common pitfalls
- Selecting the wrong agent mode wastes tokens. Use Ask mode for questions about code and Code mode only when you want file edits. The Debug agent is optimized for error analysis with stack trace parsing.
- Large codebases can exceed context limits quickly. Use
.roo/ignoreto exclude vendor directories, build artifacts, and test fixtures from the agent's file access. - Local LLM endpoints need sufficient model capability. Small models (under 7B parameters) struggle with multi-file editing tasks that Roo Code's Code agent performs.
Frequently Asked Questions
Roo Code supports OpenAI, Anthropic Claude, Google Gemini, and any OpenAI-compatible API endpoint. This includes local LLM servers like Ollama, LM Studio, and vLLM. You configure the provider in the extension settings.
Roo Code was forked from Cline and has since added custom agent modes with scoped permissions, MCP integration, cloud agents, and a multi-model configuration system. The five built-in personas (Code, Architect, Ask, Debug, Custom) are unique to Roo Code.
Model Context Protocol (MCP) lets Roo Code connect to external tools and data sources -- databases, APIs, file systems, documentation -- through standardized server interfaces. This extends the agent's capabilities without embedding all context in the prompt.
Yes. The Custom mode lets you define which tools the agent can access, what system prompt it uses, and what restrictions apply. This is useful for creating specialized agents like a security reviewer that can only read files and run linters.
Roo Code is built for VS Code and should work with compatible forks like VSCodium and Cursor. However, some forks may have extension compatibility differences. The official marketplace listing targets standard VS Code.
Citations (3)
- Roo Code GitHub— Roo Code is an open-source fork of Cline with 22K plus GitHub stars
- MCP Specification— Model Context Protocol specification for AI tool integration
- VS Code Marketplace— VS Code extension marketplace for AI coding assistants
Related on TokRepo
Source & Thanks
Created by RooCodeInc. Licensed under Apache-2.0.
Roo-Code — ⭐ 22,900+
Thanks to the Roo Code team for building the most versatile open-source AI coding extension for VS Code.
Discussion
Related Assets
Conda — Cross-Platform Package and Environment Manager
Install, update, and manage packages and isolated environments for Python, R, C/C++, and hundreds of other languages from a single tool.
Sphinx — Python Documentation Generator
Generate professional documentation from reStructuredText and Markdown with cross-references, API autodoc, and multiple output formats.
Neutralinojs — Lightweight Cross-Platform Desktop Apps
Build desktop applications with HTML, CSS, and JavaScript using a tiny native runtime instead of bundling Chromium.