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
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.25 Released
Roo Code 3.25 brings powerful new features and significant improvements to enhance your development workflow!
- **Message Queueing** - Queue multiple messages while Roo is working, allowing you to continue planning your workflow without interruption.
- **Custom Slash Commands** - Create personalized slash commands for quick access to frequently used prompts and workflows, with full UI management.
- **Enhanced Gemini Tools** - New URL context and Google Search grounding capabilities provide Gemini models with real-time web information and enhanced research abilities.
---
## 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 | 
MuriloFP | 
ColemanRoo | 
canrobins13 | 
stea9499 |
| 
jr | 
joemanley201 | 
System233 | 
roomote-agent | 
nissa-seru | 
jquanton |
| 
NyxJae | 
elianiva | 
d-oit | 
chrarnoldus | 
qdaxb | 
xyOz-dev |
| 
wkordalski | 
punkpeye | 
SannidhyaSah | 
sachasayan | 
Smartsheet-JB-Brown | 
monotykamary |
| 
cannuri | 
feifei325 | 
zhangtony239 | 
dtrugman | 
liwilliam2021 | 
shariqriazz |
| 
vigneshsubbiah16 | 
pugazhendhi-m | 
lloydchang | 
NaccOll | 
hassoncs | 
PeterDaveHello |
| 
Szpadel | 
diarmidmackenzie | 
olweraltuve | 
psv2522 | 
Premshay | 
kiwina |
| 
lupuletic | 
ChuKhaLi | 
aheizi | 
afshawnlotfi | 
RaySinner | 
noritaka1166 |
| 
nbihan-mediware | 
brunobergher | 
emshvac | 
kyle-apex | 
pdecat | 
Ruakij |
| 
StevenTCramer | 
dleffel | 
Lunchb0ne | 
SmartManoj | 
vagadiya | 
slytechnical |
| 
dlab-anton | 
arthurauffray | 
upamune | 
NamesMT | 
taylorwilsdon | 
sammcj |
| 
p12tic | 
gtaylor | 
catrielmuller | 
aitoroses | 
ross | 
mr-ryan-james |
| 
heyseth | 
taisukeoe | 
avtc | 
eonghk | 
GOODBOY008 | 
kcwhite |
| 
ronyblum | 
teddyOOXX | 
thill2323 | 
vincentsong | 
yongjer | 
zeozeozeo |
| 
ashktn | 
franekp | 
yt3trees | 
seedlord | 
benzntech | 
QuinsZouls |
| 
anton-otee | 
axkirillov | 
bramburn | 
olearycrew | 
devxpain | 
snoyiatk |
| 
GitlyHallows | 
jcbdev | 
Chenjiayuan195 | 
julionav | 
KanTakahiro | 
kevint-cerebras |
| 
SplittyDev | 
mdp | 
napter | 
philfung | 
axmo | 
bannzai |
| 
bbenshalom | 
chris-garrett | 
dairui1 | 
dqroid | 
ershang-fireworks | 
f14XuanLv |
| 
janaki-sasidhar | 
forestyoo | 
hatsu38 | 
hongzio | 
im47cn | 
asychin |
| 
amittell | 
Yoshino-Yukitaro | 
Yikai-Liao | 
zxdvd | 
s97712 | 
vladstudio |
| 
vivekfyi | 
HahaBill | 
tmsjngx0 | 
TGlide | 
Githubguy132010 | 
tgfjt |
| 
maekawataiki | 
AlexandruSmirnov | 
abumalick | 
shoopapa | 
qingyuan1109 | 
refactorthis |
| 
robertheadley | 
samir-nimbly | 
sensei-woo | 
shaybc | 
shivamd1810 | 
shohei-ihaya |
| 
shubhamgupta731 | 
student20880 | 
takakoutso | 
user202729 | 
cdlliuy | 
zetaloop |
| 
PretzelVector | 
nevermorec | 
jues | 
jwcraig | 
kinandan | 
kohii |
| 
lhish | 
lightrabbit | 
olup | 
mecab | 
mlopezr | 
moqimoqidea |
| 
mosleyit | 
nobu007 | 
oprstchn | 
village-way | 
philipnext | 
pokutuna |
| 
thecolorblue | 
chadgauth | 
CW-B-W | 
DarinVerheijke | 
dleen | 
Deon588 |
| 
dflatline | 
dbasclpy | 
EamonNerbonne | 
edwin-truthsearch-io | 
ertan2002 | 
linegel |
| 
celestial-vault | 
ExactDoug | 
pfitz | 
DeXtroTip | 
adambrand | 
AMHesch |
| 
adamhill | 
adamwlarson | 
adilhafeez | 
nexon33 | 
alarno | 
HadesArchitect |
| 
alasano | 
andreastempsch | 
andrewshu2000 | 
AntiMoron | 
atlasgong | 
Atlogit |
| 
benashby | 
bogdan0083 | 
hesara | 
marvijo-code | 
mollux | 
ecmasx |
| 
kvokka | 
Naam | 
niteshbalusu11 | 
OlegOAndreev | 
PaperBoardOfficial | 
Sarke |
| 
pwilkin | 
R-omk | 
SECKainersdorfer | 
RandalSchwartz | 
RSO | 
01Rian |
| 
samsilveira | 
jdilla1277 | 
Jdo300 | 
Fovty | 
snova-jorgep | 
joshualipman123 |
| 
Juice10 | 
AyazKaan | 
ksze | 
KevinZhao | 
kevinvandijk | 
Rexarrior |
| 
shtse8 | 
libertyteeth | 
monkeyDluffy6017 | 
mamertofabian | 
markijbema | |
## 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!
