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) • [Nederlands](locales/nl/README.md) • [Русский](locales/ru/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)

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.18 Released Roo Code 3.18 brings powerful new features and improvements based on your feedback! - **Gemini 2.5 Flash Preview Models** - Access the latest Gemini Flash models for faster and more efficient responses. - **Intelligent Context Condensing Button** - New button in task header lets you intelligently condense content with visual feedback. - **YAML Support for Mode Definitions** - Create and customize modes more easily with YAML support. --- ## 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**: Press `F5` (or **Run** → **Start Debugging**) in VSCode to open a new window with Roo Code running. 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 pnpm 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 | hannesrudolph
hannesrudolph | KJ7LNW
KJ7LNW | stea9499
stea9499 | canrobins13
canrobins13 | joemanley201
joemanley201 | | System233
System233 | nissa-seru
nissa-seru | jquanton
jquanton | NyxJae
NyxJae | MuriloFP
MuriloFP | d-oit
d-oit | | punkpeye
punkpeye | wkordalski
wkordalski | Smartsheet-JB-Brown
Smartsheet-JB-Brown | monotykamary
monotykamary | elianiva
elianiva | feifei325
feifei325 | | zhangtony239
zhangtony239 | cannuri
cannuri | lloydchang
lloydchang | sachasayan
sachasayan | vigneshsubbiah16
vigneshsubbiah16 | qdaxb
qdaxb | | Szpadel
Szpadel | diarmidmackenzie
diarmidmackenzie | psv2522
psv2522 | Premshay
Premshay | lupuletic
lupuletic | shariqriazz
shariqriazz | | xyOz-dev
xyOz-dev | pugazhendhi-m
pugazhendhi-m | aheizi
aheizi | olweraltuve
olweraltuve | jr
jr | dtrugman
dtrugman | | nbihan-mediware
nbihan-mediware | PeterDaveHello
PeterDaveHello | RaySinner
RaySinner | afshawnlotfi
afshawnlotfi | emshvac
emshvac | kyle-apex
kyle-apex | | pdecat
pdecat | Lunchb0ne
Lunchb0ne | vagadiya
vagadiya | arthurauffray
arthurauffray | upamune
upamune | StevenTCramer
StevenTCramer | | sammcj
sammcj | p12tic
p12tic | gtaylor
gtaylor | aitoroses
aitoroses | noritaka1166
noritaka1166 | philfung
philfung | | ross
ross | heyseth
heyseth | taisukeoe
taisukeoe | dlab-anton
dlab-anton | eonghk
eonghk | teddyOOXX
teddyOOXX | | vincentsong
vincentsong | yongjer
yongjer | SmartManoj
SmartManoj | ashktn
ashktn | franekp
franekp | yt3trees
yt3trees | | benzntech
benzntech | anton-otee
anton-otee | axkirillov
axkirillov | bramburn
bramburn | hassoncs
hassoncs | ChuKhaLi
ChuKhaLi | | snoyiatk
snoyiatk | GitlyHallows
GitlyHallows | jcbdev
jcbdev | Chenjiayuan195
Chenjiayuan195 | julionav
julionav | SplittyDev
SplittyDev | | mdp
mdp | napter
napter | hatsu38
hatsu38 | hongzio
hongzio | im47cn
im47cn | shoopapa
shoopapa | | jwcraig
jwcraig | kinandan
kinandan | kohii
kohii | lightrabbit
lightrabbit | olup
olup | nevermorec
nevermorec | | GOODBOY008
GOODBOY008 | dqroid
dqroid | dairui1
dairui1 | bannzai
bannzai | axmo
axmo | avtc
avtc | | asychin
asychin | amittell
amittell | Yoshino-Yukitaro
Yoshino-Yukitaro | Yikai-Liao
Yikai-Liao | PretzelVector
PretzelVector | zetaloop
zetaloop | | zeozeozeo
zeozeozeo | cdlliuy
cdlliuy | student20880
student20880 | shohei-ihaya
shohei-ihaya | shaybc
shaybc | seedlord
seedlord | | samir-nimbly
samir-nimbly | ronyblum
ronyblum | robertheadley
robertheadley | refactorthis
refactorthis | pokutuna
pokutuna | philipnext
philipnext | | oprstchn
oprstchn | nobu007
nobu007 | mosleyit
mosleyit | moqimoqidea
moqimoqidea | mlopezr
mlopezr | mecab
mecab | | zxdvd
zxdvd | hesara
hesara | DeXtroTip
DeXtroTip | pfitz
pfitz | celestial-vault
celestial-vault | linegel
linegel | | dbasclpy
dbasclpy | Deon588
Deon588 | dleen
dleen | chadgauth
chadgauth | olearycrew
olearycrew | bogdan0083
bogdan0083 | | Atlogit
Atlogit | atlasgong
atlasgong | andreastempsch
andreastempsch | alasano
alasano | QuinsZouls
QuinsZouls | HadesArchitect
HadesArchitect | | alarno
alarno | adamwlarson
adamwlarson | AMHesch
AMHesch | vladstudio
vladstudio | NamesMT
NamesMT | tmsjngx0
tmsjngx0 | | tgfjt
tgfjt | maekawataiki
maekawataiki | samsilveira
samsilveira | mr-ryan-james
mr-ryan-james | 01Rian
01Rian | RSO
RSO | | R-omk
R-omk | Sarke
Sarke | kvokka
kvokka | ecmasx
ecmasx | marvijo-code
marvijo-code | mamertofabian
mamertofabian | | monkeyDluffy6017
monkeyDluffy6017 | libertyteeth
libertyteeth | shtse8
shtse8 | ksze
ksze | Jdo300
Jdo300 | | ## 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!