# 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.

## Install

Save in your project root:

# Roo Code — AI Coding Team Inside VS Code

## Quick Use

1. Open VS Code Extensions panel (Ctrl+Shift+X)
2. Search "Roo Code" and install
3. Or install via CLI:

```bash
code --install-extension RooVeterinaryInc.roo-cline
```

4. Open the Roo Code sidebar (click the Roo icon)
5. Configure your preferred AI provider (OpenAI, Anthropic, local LLMs, etc.)

---

## Intro

Roo Code is a free, open-source AI coding extension for VS Code that puts a full team of AI agents inside your editor. Originally forked from Cline, it has grown into a standalone product with 22,900+ GitHub stars, custom agent modes, multi-model support, and MCP integration. Unlike single-purpose AI assistants, Roo Code offers 5 built-in personas — Code, Architect, Ask, Debug, and Custom — each with scoped tool permissions so the right agent handles the right task.

Works with: VS Code, OpenAI, Anthropic Claude, Google Gemini, local LLMs via Ollama. Best for developers who want a configurable, multi-modal AI assistant embedded in their editor. Setup time: under 2 minutes.

---

## Roo Code Features & Architecture

### Built-in Agent Modes

Roo Code ships with 5 specialized modes, each with different tool permissions:

| Mode | Purpose | Can Edit Files | Can Run Terminal |
|------|---------|---------------|-----------------|
| **Code** | Write and refactor code | ✅ | ✅ |
| **Architect** | Design systems, plan changes | ❌ | ❌ |
| **Ask** | Answer questions about codebase | ❌ | ❌ |
| **Debug** | Diagnose and fix bugs | ✅ | ✅ |
| **Custom** | User-defined persona & permissions | Configurable | Configurable |

### Custom Modes

Create your own agent personas with:
- Custom system prompts
- Scoped file/folder access
- Selective tool permissions (edit, terminal, browser, MCP)
- Model override per mode

### MCP Integration

Roo Code supports Model Context Protocol (MCP) for connecting external tools:

```json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}
```

### Boomerang Tasks

Break complex challenges into subtasks that automatically route to the right agent mode. The orchestrator agent delegates work, collects results, and synthesizes the final output.

### Cloud Agents

Run Roo Code agents 24/7 in the cloud via:
- **Slack integration** — trigger coding tasks from Slack messages
- **GitHub integration** — auto-respond to issues and PRs
- Agents work autonomously, commit code, and report back

### Multi-Provider Support

Compatible with 100+ AI models:
- OpenAI (GPT-4, GPT-4o)
- Anthropic (Claude 4.5, Claude 4.6)
- Google (Gemini 2.5)
- Local models via Ollama, LM Studio, vLLM
- Azure, AWS Bedrock, OpenRouter

### Browser Control

Built-in browser for:
- Testing web applications
- Capturing screenshots
- Running end-to-end tests
- Debugging visual issues

---

## FAQ

**Q: What is Roo Code?**
A: Roo Code is a free, open-source VS Code extension that provides multiple AI agent modes (Code, Architect, Debug, Ask, Custom) with MCP support and 100+ model providers. It's the most customizable AI coding assistant for VS Code.

**Q: How is Roo Code different from Cline?**
A: Roo Code was forked from Cline and adds custom modes with scoped permissions, Boomerang task orchestration, cloud agents, and more granular configuration. Cline focuses on a single autonomous agent; Roo Code provides a team of specialized agents.

**Q: Is Roo Code free?**
A: Yes, completely free and open-source under Apache-2.0. You bring your own API keys for the AI providers you use.

---

## Source & Thanks

> Created by [RooCodeInc](https://github.com/RooCodeInc). Licensed under Apache-2.0.
>
> [Roo-Code](https://github.com/RooCodeInc/Roo-Code) — ⭐ 22,900+

Thanks to the Roo Code team for building the most versatile open-source AI coding extension for VS Code.

---

<!-- ZH -->

## 快速使用

1. 打开 VS Code 扩展面板（Ctrl+Shift+X）
2. 搜索 "Roo Code" 并安装
3. 或使用命令行安装：

```bash
code --install-extension RooVeterinaryInc.roo-cline
```

4. 打开 Roo Code 侧边栏（点击 Roo 图标）
5. 配置你偏好的 AI 提供商（OpenAI、Anthropic、本地模型等）

---

## 简介

Roo Code 是一个免费开源的 VS Code AI 编码扩展，在编辑器内提供一整个 AI 代理团队。它从 Cline 分叉而来，已发展为拥有 22,900+ GitHub stars 的独立产品，支持自定义代理模式、多模型切换和 MCP 集成。内置 5 种代理人格 — Code（编码）、Architect（架构）、Ask（提问）、Debug（调试）和 Custom（自定义），每种都有独立的工具权限。

适用于：VS Code、OpenAI、Anthropic Claude、Google Gemini、Ollama 本地模型。适合需要高度可配置 AI 助手的开发者。

---

## Roo Code 功能与架构

### 内置代理模式

| 模式 | 用途 | 可编辑文件 | 可运行终端 |
|------|------|-----------|-----------|
| **Code** | 编写和重构代码 | ✅ | ✅ |
| **Architect** | 系统设计、规划变更 | ❌ | ❌ |
| **Ask** | 回答代码库问题 | ❌ | ❌ |
| **Debug** | 诊断和修复 bug | ✅ | ✅ |
| **Custom** | 自定义人格和权限 | 可配置 | 可配置 |

### MCP 集成

支持模型上下文协议（MCP），连接外部工具和数据源。

### Boomerang 任务

将复杂挑战拆分为子任务，自动路由到合适的代理模式。

### 云端代理

通过 Slack 和 GitHub 集成，7×24 小时运行 AI 代理。

---

## 来源与感谢

> Created by [RooCodeInc](https://github.com/RooCodeInc). Licensed under Apache-2.0.
>
> [Roo-Code](https://github.com/RooCodeInc/Roo-Code) — ⭐ 22,900+


---
Source: https://tokrepo.com/en/workflows/704bfd36-292d-4717-835b-e4822e8108ee
Author: AI Open Source