diff --git a/README.vscode.md b/README.vscode.md
new file mode 100644
index 00000000000..bd929d2e130
--- /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.
+
+
+
+
+
+
+
+
+
+**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 | 
saoudrizwan | 
cte | 
daniel-lxs | 
samhvw8 | 
hannesrudolph |
+| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
+| 
KJ7LNW | 
a8trejo | 
ColemanRoo | 
MuriloFP | 
canrobins13 | 
stea9499 |
+| 
joemanley201 | 
System233 | 
jr | 
nissa-seru | 
jquanton | 
roomote-agent |
+| 
NyxJae | 
d-oit | 
elianiva | 
wkordalski | 
qdaxb | 
punkpeye |
+| 
SannidhyaSah | 
xyOz-dev | 
chrarnoldus | 
sachasayan | 
Smartsheet-JB-Brown | 
monotykamary |
+| 
cannuri | 
feifei325 | 
zhangtony239 | 
shariqriazz | 
vigneshsubbiah16 | 
pugazhendhi-m |
+| 
lloydchang | 
dtrugman | 
Szpadel | 
lupuletic | 
kiwina | 
liwilliam2021 |
+| 
Premshay | 
psv2522 | 
olweraltuve | 
diarmidmackenzie | 
hassoncs | 
ChuKhaLi |
+| 
PeterDaveHello | 
aheizi | 
nbihan-mediware | 
noritaka1166 | 
RaySinner | 
afshawnlotfi |
+| 
dleffel | 
StevenTCramer | 
Ruakij | 
pdecat | 
kyle-apex | 
emshvac |
+| 
Lunchb0ne | 
SmartManoj | 
vagadiya | 
slytechnical | 
dlab-anton | 
arthurauffray |
+| 
upamune | 
NamesMT | 
taylorwilsdon | 
{
copyPaths(
[
- ["../README.md", "README.md"],
+ ["../README.vscode.md", "README.md"],
["../CHANGELOG.md", "CHANGELOG.md"],
["../LICENSE", "LICENSE"],
["../.env", ".env", { optional: true }],
+
+
+
+
+