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) • [Italiano](locales/it/README.md) [日本語](locales/ja/README.md) • [한국어](locales/ko/README.md) • [Polski](locales/pl/README.md) • [Português (BR)](locales/pt-BR/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)

Join the Roo Code Community

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

Join Discord Join Reddit


Roo Code (prev. Roo Cline)

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.11 Released Roo Code 3.11 brings significant performance improvements and new features! - Fast Edits - Edits now apply way faster. Less waiting, more coding. - API Key Balances - View your OpenRouter and Requesty balances in settings. - Project-Level MCP Config - Now you can configure it per project/workspace. - Improved Gemini Support - Smarter retries, fixed escaping, added to Vertex provider. - Import/Export Settings - Easily back up or share your config across setups. --- ## 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/RooVetGit/Roo-Code/issues) or request [features](https://github.com/RooVetGit/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/RooVetGit/Roo-Code.git ``` 2. **Install dependencies**: ```sh npm run install:all ``` 3. **Start the webview (Vite/React app with HMR)**: ```sh npm run dev ``` 4. **Debug**: Press `F5` (or **Run** → **Start Debugging**) in VSCode to open a new session with Roo Code loaded. Changes to the webview will appear immediately. Changes to the core extension will require a restart of the extension host. Alternatively you can build a .vsix and install it directly in VSCode: ```sh npm run build ``` A `.vsix` file will appear in the `bin/` directory which can be installed with: ```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 | samhvw8
samhvw8 | daniel-lxs
daniel-lxs | a8trejo
a8trejo | | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | ColemanRoo
ColemanRoo | stea9499
stea9499 | joemanley201
joemanley201 | System233
System233 | hannesrudolph
hannesrudolph | jquanton
jquanton | | nissa-seru
nissa-seru | NyxJae
NyxJae | MuriloFP
MuriloFP | punkpeye
punkpeye | d-oit
d-oit | monotykamary
monotykamary | | Smartsheet-JB-Brown
Smartsheet-JB-Brown | feifei325
feifei325 | vigneshsubbiah16
vigneshsubbiah16 | lloydchang
lloydchang | KJ7LNW
KJ7LNW | cannuri
cannuri | | Szpadel
Szpadel | wkordalski
wkordalski | lupuletic
lupuletic | qdaxb
qdaxb | Premshay
Premshay | psv2522
psv2522 | | olweraltuve
olweraltuve | diarmidmackenzie
diarmidmackenzie | RaySinner
RaySinner | aheizi
aheizi | afshawnlotfi
afshawnlotfi | pugazhendhi-m
pugazhendhi-m | | PeterDaveHello
PeterDaveHello | pdecat
pdecat | kyle-apex
kyle-apex | emshvac
emshvac | aitoroses
aitoroses | dtrugman
dtrugman | | p12tic
p12tic | sammcj
sammcj | Lunchb0ne
Lunchb0ne | heyseth
heyseth | StevenTCramer
StevenTCramer | upamune
upamune | | arthurauffray
arthurauffray | eonghk
eonghk | teddyOOXX
teddyOOXX | vincentsong
vincentsong | yongjer
yongjer | yt3trees
yt3trees | | anton-otee
anton-otee | benzntech
benzntech | GitlyHallows
GitlyHallows | gtaylor
gtaylor | jcbdev
jcbdev | Chenjiayuan195
Chenjiayuan195 | | mdp
mdp | napter
napter | philfung
philfung | kohii
kohii | kinandan
kinandan | jwcraig
jwcraig | | shoopapa
shoopapa | im47cn
im47cn | dqroid
dqroid | dairui1
dairui1 | bannzai
bannzai | axmo
axmo | | ashktn
ashktn | Yoshino-Yukitaro
Yoshino-Yukitaro | vladstudio
vladstudio | AMHesch
AMHesch | lightrabbit
lightrabbit | olup
olup | | moqimoqidea
moqimoqidea | mosleyit
mosleyit | oprstchn
oprstchn | philipnext
philipnext | refactorthis
refactorthis | samir-nimbly
samir-nimbly | | shaybc
shaybc | shohei-ihaya
shohei-ihaya | student20880
student20880 | cdlliuy
cdlliuy | PretzelVector
PretzelVector | nevermorec
nevermorec | | adamwlarson
adamwlarson | alarno
alarno | andreastempsch
andreastempsch | Atlogit
Atlogit | bramburn
bramburn | chadgauth
chadgauth | | dleen
dleen | dbasclpy
dbasclpy | snoyiatk
snoyiatk | linegel
linegel | celestial-vault
celestial-vault | franekp
franekp | | DeXtroTip
DeXtroTip | hesara
hesara | eltociear
eltociear | Jdo300
Jdo300 | libertyteeth
libertyteeth | mamertofabian
mamertofabian | | marvijo-code
marvijo-code | kvokka
kvokka | nbihan-mediware
nbihan-mediware | Sarke
Sarke | 01Rian
01Rian | samsilveira
samsilveira | | maekawataiki
maekawataiki | tgfjt
tgfjt | thomasjeung
thomasjeung | | | | ## License [Apache 2.0 © 2025 Roo Code, Inc.](./LICENSE) --- **Enjoy Roo Code!** Whether you keep it on a short leash or let it roam autonomously, we can’t wait to see what you build. If you have questions or feature ideas, drop by our [Reddit community](https://www.reddit.com/r/RooCode/) or [Discord](https://discord.gg/roocode). Happy coding!