From 18a0ca7dafaa05e5db6cea85a6d06462edb236ea Mon Sep 17 00:00:00 2001 From: Roo Code Date: Mon, 28 Jul 2025 18:39:56 +0000 Subject: [PATCH 1/2] fix: remove demo GIF from VS Code README to prevent marketplace freezing - Created README.vscode.md without the large 7.46MB demo GIF - Kept the full contributor section as requested - Updated build scripts to use README.vscode.md for VS Code builds - This is a temporary fix to test if removing the GIF resolves the freezing issue --- README.vscode.md | 220 ++++++++++++++++++++++++++++++++ apps/vscode-nightly/esbuild.mjs | 2 +- src/esbuild.mjs | 2 +- 3 files changed, 222 insertions(+), 2 deletions(-) create mode 100644 README.vscode.md diff --git a/README.vscode.md b/README.vscode.md new file mode 100644 index 0000000000..bd929d2e13 --- /dev/null +++ b/README.vscode.md @@ -0,0 +1,220 @@ +
+ + +English • [Català](locales/ca/README.md) • [Deutsch](locales/de/README.md) • [Español](locales/es/README.md) • [Français](locales/fr/README.md) • [हिंदी](locales/hi/README.md) • [Bahasa Indonesia](locales/id/README.md) • [Italiano](locales/it/README.md) • [日本語](locales/ja/README.md) + + + + +[한국어](locales/ko/README.md) • [Nederlands](locales/nl/README.md) • [Polski](locales/pl/README.md) • [Português (BR)](locales/pt-BR/README.md) • [Русский](locales/ru/README.md) • [Türkçe](locales/tr/README.md) • [Tiếng Việt](locales/vi/README.md) • [简体中文](locales/zh-CN/README.md) • [繁體中文](locales/zh-TW/README.md) + + +
+
+
+

Roo Code (prev. Roo Cline)

+

Connect with developers, contribute ideas, and stay ahead with the latest AI-powered coding tools.

+ + Join Discord + Join Reddit + +
+
+
+ +
+ +Download on VS Marketplace +Feature Requests +Rate & Review +Documentation + +
+ +**Roo Code** is an AI-powered **autonomous coding agent** that lives in your editor. It can: + +- Communicate in natural language +- Read and write files directly in your workspace +- Run terminal commands +- Automate browser actions +- Integrate with any OpenAI-compatible or custom API/model +- Adapt its "personality" and capabilities through **Custom Modes** + +Whether you're seeking a flexible coding partner, a system architect, or specialized roles like a QA engineer or product manager, Roo Code can help you build software more efficiently. + +Check out the [CHANGELOG](CHANGELOG.md) for detailed updates and fixes. + +--- + +## 🎉 Roo Code 3.24 Released + +Roo Code 3.24 brings powerful new features and significant improvements to enhance your development workflow! + +- **Hugging Face Provider** - Access tons of great open source models directly through the new Hugging Face provider with seamless integration and model selection. +- **Inline Command Controls** - New auto-approve and deny controls for command execution give you precise control over terminal operations with customizable permissions. +- **AGENTS.md Rules Support** - Adds support for a community standard AGENTS.md file in the root of the project. + +--- + +## What Can Roo Code Do? + +- 🚀 **Generate Code** from natural language descriptions +- 🔧 **Refactor & Debug** existing code +- 📝 **Write & Update** documentation +- 🤔 **Answer Questions** about your codebase +- 🔄 **Automate** repetitive tasks +- 🏗️ **Create** new files and projects + +## Quick Start + +1. [Install Roo Code](https://docs.roocode.com/getting-started/installing) +2. [Connect Your AI Provider](https://docs.roocode.com/getting-started/connecting-api-provider) +3. [Try Your First Task](https://docs.roocode.com/getting-started/your-first-task) + +## Key Features + +### Multiple Modes + +Roo Code adapts to your needs with specialized [modes](https://docs.roocode.com/basic-usage/using-modes): + +- **Code Mode:** For general-purpose coding tasks +- **Architect Mode:** For planning and technical leadership +- **Ask Mode:** For answering questions and providing information +- **Debug Mode:** For systematic problem diagnosis +- **[Custom Modes](https://docs.roocode.com/advanced-usage/custom-modes):** Create unlimited specialized personas for security auditing, performance optimization, documentation, or any other task + +### Smart Tools + +Roo Code comes with powerful [tools](https://docs.roocode.com/basic-usage/how-tools-work) that can: + +- Read and write files in your project +- Execute commands in your VS Code terminal +- Control a web browser +- Use external tools via [MCP (Model Context Protocol)](https://docs.roocode.com/advanced-usage/mcp) + +MCP extends Roo Code's capabilities by allowing you to add unlimited custom tools. Integrate with external APIs, connect to databases, or create specialized development tools - MCP provides the framework to expand Roo Code's functionality to meet your specific needs. + +### Customization + +Make Roo Code work your way with: + +- [Custom Instructions](https://docs.roocode.com/advanced-usage/custom-instructions) for personalized behavior +- [Custom Modes](https://docs.roocode.com/advanced-usage/custom-modes) for specialized tasks +- [Local Models](https://docs.roocode.com/advanced-usage/local-models) for offline use +- [Auto-Approval Settings](https://docs.roocode.com/advanced-usage/auto-approving-actions) for faster workflows + +## Resources + +### Documentation + +- [Basic Usage Guide](https://docs.roocode.com/basic-usage/the-chat-interface) +- [Advanced Features](https://docs.roocode.com/advanced-usage/auto-approving-actions) +- [Frequently Asked Questions](https://docs.roocode.com/faq) + +### Community + +- **Discord:** [Join our Discord server](https://discord.gg/roocode) for real-time help and discussions +- **Reddit:** [Visit our subreddit](https://www.reddit.com/r/RooCode) to share experiences and tips +- **GitHub:** Report [issues](https://github.com/RooCodeInc/Roo-Code/issues) or request [features](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop) + +--- + +## Local Setup & Development + +1. **Clone** the repo: + +```sh +git clone https://github.com/RooCodeInc/Roo-Code.git +``` + +2. **Install dependencies**: + +```sh +pnpm install +``` + +3. **Run the extension**: + +There are several ways to run the Roo Code extension: + +### Development Mode (F5) + +For active development, use VSCode's built-in debugging: + +Press `F5` (or go to **Run** → **Start Debugging**) in VSCode. This will open a new VSCode window with the Roo Code extension running. + +- Changes to the webview will appear immediately. +- Changes to the core extension will also hot reload automatically. + +### Automated VSIX Installation + +To build and install the extension as a VSIX package directly into VSCode: + +```sh +pnpm install:vsix [-y] [--editor=] +``` + +This command will: + +- Ask which editor command to use (code/cursor/code-insiders) - defaults to 'code' +- Uninstall any existing version of the extension. +- Build the latest VSIX package. +- Install the newly built VSIX. +- Prompt you to restart VS Code for changes to take effect. + +Options: + +- `-y`: Skip all confirmation prompts and use defaults +- `--editor=`: Specify the editor command (e.g., `--editor=cursor` or `--editor=code-insiders`) + +### Manual VSIX Installation + +If you prefer to install the VSIX package manually: + +1. First, build the VSIX package: + ```sh + pnpm vsix + ``` +2. A `.vsix` file will be generated in the `bin/` directory (e.g., `bin/roo-cline-.vsix`). +3. Install it manually using the VSCode CLI: + ```sh + code --install-extension bin/roo-cline-.vsix + ``` + +--- + +We use [changesets](https://github.com/changesets/changesets) for versioning and publishing. Check our `CHANGELOG.md` for release notes. + +--- + +## Disclaimer + +**Please note** that Roo Code, Inc does **not** make any representations or warranties regarding any code, models, or other tools provided or made available in connection with Roo Code, any associated third-party tools, or any resulting outputs. You assume **all risks** associated with the use of any such tools or outputs; such tools are provided on an **"AS IS"** and **"AS AVAILABLE"** basis. Such risks may include, without limitation, intellectual property infringement, cyber vulnerabilities or attacks, bias, inaccuracies, errors, defects, viruses, downtime, property loss or damage, and/or personal injury. You are solely responsible for your use of any such tools or outputs (including, without limitation, the legality, appropriateness, and results thereof). + +--- + +## Contributing + +We love community contributions! Get started by reading our [CONTRIBUTING.md](CONTRIBUTING.md). + +--- + +## Contributors + +Thanks to all our contributors who have helped make Roo Code better! + + + +| mrubens
mrubens | saoudrizwan
saoudrizwan | cte
cte | daniel-lxs
daniel-lxs | samhvw8
samhvw8 | hannesrudolph
hannesrudolph | +| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | +| KJ7LNW
KJ7LNW | a8trejo
a8trejo | ColemanRoo
ColemanRoo | MuriloFP
MuriloFP | canrobins13
canrobins13 | stea9499
stea9499 | +| joemanley201
joemanley201 | System233
System233 | jr
jr | nissa-seru
nissa-seru | jquanton
jquanton | roomote-agent
roomote-agent | +| NyxJae
NyxJae | d-oit
d-oit | elianiva
elianiva | wkordalski
wkordalski | qdaxb
qdaxb | punkpeye
punkpeye | +| SannidhyaSah
SannidhyaSah | xyOz-dev
xyOz-dev | chrarnoldus
chrarnoldus | sachasayan
sachasayan | Smartsheet-JB-Brown
Smartsheet-JB-Brown | monotykamary
monotykamary | +| cannuri
cannuri | feifei325
feifei325 | zhangtony239
zhangtony239 | shariqriazz
shariqriazz | vigneshsubbiah16
vigneshsubbiah16 | pugazhendhi-m
pugazhendhi-m | +| lloydchang
lloydchang | dtrugman
dtrugman | Szpadel
Szpadel | lupuletic
lupuletic | kiwina
kiwina | liwilliam2021
liwilliam2021 | +| Premshay
Premshay | psv2522
psv2522 | olweraltuve
olweraltuve | diarmidmackenzie
diarmidmackenzie | hassoncs
hassoncs | ChuKhaLi
ChuKhaLi | +| PeterDaveHello
PeterDaveHello | aheizi
aheizi | nbihan-mediware
nbihan-mediware | noritaka1166
noritaka1166 | RaySinner
RaySinner | afshawnlotfi
afshawnlotfi | +| dleffel
dleffel | StevenTCramer
StevenTCramer | Ruakij
Ruakij | pdecat
pdecat | kyle-apex
kyle-apex | emshvac
emshvac | +| Lunchb0ne
Lunchb0ne | SmartManoj
SmartManoj | vagadiya
vagadiya | slytechnical
slytechnical | dlab-anton
dlab-anton | arthurauffray
arthurauffray | +| upamune
upamune | NamesMT
NamesMT | taylorwilsdon
taylorwilsdon | { copyPaths( [ - ["../README.md", "README.md"], + ["../README.vscode.md", "README.md"], ["../CHANGELOG.md", "CHANGELOG.md"], ["../LICENSE", "LICENSE"], ["../.env", ".env", { optional: true }], diff --git a/src/esbuild.mjs b/src/esbuild.mjs index f99b077e9f..0946dac28f 100644 --- a/src/esbuild.mjs +++ b/src/esbuild.mjs @@ -49,7 +49,7 @@ async function main() { build.onEnd(() => { copyPaths( [ - ["../README.md", "README.md"], + ["../README.vscode.md", "README.md"], ["../CHANGELOG.md", "CHANGELOG.md"], ["../LICENSE", "LICENSE"], ["../.env", ".env", { optional: true }], From 1dc0626ba654af3a8a36502d6176a16a8bac7468 Mon Sep 17 00:00:00 2001 From: Roo Code Date: Mon, 28 Jul 2025 19:24:11 +0000 Subject: [PATCH 2/2] fix: apply README GIF removal only to nightly builds - Reverted src/esbuild.mjs to use regular README.md - Kept apps/vscode-nightly/esbuild.mjs using README.vscode.md - This ensures the demo GIF is removed only from nightly builds as requested --- src/esbuild.mjs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/esbuild.mjs b/src/esbuild.mjs index 0946dac28f..f99b077e9f 100644 --- a/src/esbuild.mjs +++ b/src/esbuild.mjs @@ -49,7 +49,7 @@ async function main() { build.onEnd(() => { copyPaths( [ - ["../README.vscode.md", "README.md"], + ["../README.md", "README.md"], ["../CHANGELOG.md", "CHANGELOG.md"], ["../LICENSE", "LICENSE"], ["../.env", ".env", { optional: true }],