|
| 1 | +<div align="center"> |
| 2 | +<sub> |
| 3 | + |
| 4 | +<b>English</b> • [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) |
| 5 | + |
| 6 | +</sub> |
| 7 | +<sub> |
| 8 | + |
| 9 | +[한국어](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) |
| 10 | + |
| 11 | +</sub> |
| 12 | +</div> |
| 13 | +<br> |
| 14 | +<div align="center"> |
| 15 | + <h1>Roo Code (prev. Roo Cline)</h1> |
| 16 | + <p align="center"> |
| 17 | + <img src="https://media.githubusercontent.com/media/RooCodeInc/Roo-Code/main/src/assets/docs/demo.gif" width="100%" /> |
| 18 | + </p> |
| 19 | + <p>Connect with developers, contribute ideas, and stay ahead with the latest AI-powered coding tools.</p> |
| 20 | + |
| 21 | + <a href="https://discord.gg/roocode" target="_blank"><img src="https://img.shields.io/badge/Join%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join Discord"></a> |
| 22 | + <a href="https://www.reddit.com/r/RooCode/" target="_blank"><img src="https://img.shields.io/badge/Join%20Reddit-FF4500?style=for-the-badge&logo=reddit&logoColor=white" alt="Join Reddit"></a> |
| 23 | + |
| 24 | +</div> |
| 25 | +<br> |
| 26 | +<br> |
| 27 | + |
| 28 | +<div align="center"> |
| 29 | + |
| 30 | +<a href="https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline" target="_blank"><img src="https://img.shields.io/badge/Download%20on%20VS%20Marketplace-blue?style=for-the-badge&logo=visualstudiocode&logoColor=white" alt="Download on VS Marketplace"></a> |
| 31 | +<a href="https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop" target="_blank"><img src="https://img.shields.io/badge/Feature%20Requests-yellow?style=for-the-badge" alt="Feature Requests"></a> |
| 32 | +<a href="https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline&ssr=false#review-details" target="_blank"><img src="https://img.shields.io/badge/Rate%20%26%20Review-green?style=for-the-badge" alt="Rate & Review"></a> |
| 33 | +<a href="https://docs.roocode.com" target="_blank"><img src="https://img.shields.io/badge/Documentation-6B46C1?style=for-the-badge&logo=readthedocs&logoColor=white" alt="Documentation"></a> |
| 34 | + |
| 35 | +</div> |
| 36 | + |
| 37 | +**Roo Code** is an AI-powered **autonomous coding agent** that lives in your editor. It can: |
| 38 | + |
| 39 | +- Communicate in natural language |
| 40 | +- Read and write files directly in your workspace |
| 41 | +- Run terminal commands |
| 42 | +- Automate browser actions |
| 43 | +- Integrate with any OpenAI-compatible or custom API/model |
| 44 | +- Adapt its "personality" and capabilities through **Custom Modes** |
| 45 | + |
| 46 | +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. |
| 47 | + |
| 48 | +Check out the [CHANGELOG](https://github.com/RooCodeInc/Roo-Code/blob/main/CHANGELOG.md) for detailed updates and fixes. |
| 49 | + |
| 50 | +--- |
| 51 | + |
| 52 | +## 🎉 Roo Code 3.24 Released |
| 53 | + |
| 54 | +Roo Code 3.24 brings powerful new features and significant improvements to enhance your development workflow! |
| 55 | + |
| 56 | +- **Hugging Face Provider** - Access tons of great open source models directly through the new Hugging Face provider with seamless integration and model selection. |
| 57 | +- **Inline Command Controls** - New auto-approve and deny controls for command execution give you precise control over terminal operations with customizable permissions. |
| 58 | +- **AGENTS.md Rules Support** - Adds support for a community standard AGENTS.md file in the root of the project. |
| 59 | + |
| 60 | +--- |
| 61 | + |
| 62 | +## What Can Roo Code Do? |
| 63 | + |
| 64 | +- 🚀 **Generate Code** from natural language descriptions |
| 65 | +- 🔧 **Refactor & Debug** existing code |
| 66 | +- 📝 **Write & Update** documentation |
| 67 | +- 🤔 **Answer Questions** about your codebase |
| 68 | +- 🔄 **Automate** repetitive tasks |
| 69 | +- 🏗️ **Create** new files and projects |
| 70 | + |
| 71 | +## Quick Start |
| 72 | + |
| 73 | +1. [Install Roo Code](https://docs.roocode.com/getting-started/installing) |
| 74 | +2. [Connect Your AI Provider](https://docs.roocode.com/getting-started/connecting-api-provider) |
| 75 | +3. [Try Your First Task](https://docs.roocode.com/getting-started/your-first-task) |
| 76 | + |
| 77 | +## Key Features |
| 78 | + |
| 79 | +### Multiple Modes |
| 80 | + |
| 81 | +Roo Code adapts to your needs with specialized [modes](https://docs.roocode.com/basic-usage/using-modes): |
| 82 | + |
| 83 | +- **Code Mode:** For general-purpose coding tasks |
| 84 | +- **Architect Mode:** For planning and technical leadership |
| 85 | +- **Ask Mode:** For answering questions and providing information |
| 86 | +- **Debug Mode:** For systematic problem diagnosis |
| 87 | +- **[Custom Modes](https://docs.roocode.com/advanced-usage/custom-modes):** Create unlimited specialized personas for security auditing, performance optimization, documentation, or any other task |
| 88 | + |
| 89 | +### Smart Tools |
| 90 | + |
| 91 | +Roo Code comes with powerful [tools](https://docs.roocode.com/basic-usage/how-tools-work) that can: |
| 92 | + |
| 93 | +- Read and write files in your project |
| 94 | +- Execute commands in your VS Code terminal |
| 95 | +- Control a web browser |
| 96 | +- Use external tools via [MCP (Model Context Protocol)](https://docs.roocode.com/advanced-usage/mcp) |
| 97 | + |
| 98 | +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. |
| 99 | + |
| 100 | +### Customization |
| 101 | + |
| 102 | +Make Roo Code work your way with: |
| 103 | + |
| 104 | +- [Custom Instructions](https://docs.roocode.com/advanced-usage/custom-instructions) for personalized behavior |
| 105 | +- [Custom Modes](https://docs.roocode.com/advanced-usage/custom-modes) for specialized tasks |
| 106 | +- [Local Models](https://docs.roocode.com/advanced-usage/local-models) for offline use |
| 107 | +- [Auto-Approval Settings](https://docs.roocode.com/advanced-usage/auto-approving-actions) for faster workflows |
| 108 | + |
| 109 | +## Resources |
| 110 | + |
| 111 | +### Documentation |
| 112 | + |
| 113 | +- [Basic Usage Guide](https://docs.roocode.com/basic-usage/the-chat-interface) |
| 114 | +- [Advanced Features](https://docs.roocode.com/advanced-usage/auto-approving-actions) |
| 115 | +- [Frequently Asked Questions](https://docs.roocode.com/faq) |
| 116 | + |
| 117 | +### Community |
| 118 | + |
| 119 | +- **Discord:** [Join our Discord server](https://discord.gg/roocode) for real-time help and discussions |
| 120 | +- **Reddit:** [Visit our subreddit](https://www.reddit.com/r/RooCode) to share experiences and tips |
| 121 | +- **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) |
| 122 | + |
| 123 | +--- |
| 124 | + |
| 125 | +## Contributing |
| 126 | + |
| 127 | +We love community contributions! Get started by reading our [CONTRIBUTING.md](https://github.com/RooCodeInc/Roo-Code/blob/main/CONTRIBUTING.md). |
| 128 | + |
| 129 | +View our full list of [contributors on GitHub](https://github.com/RooCodeInc/Roo-Code#contributors). |
| 130 | + |
| 131 | +--- |
| 132 | + |
| 133 | +## License |
| 134 | + |
| 135 | +[Apache 2.0 © 2025 Roo Code, Inc.](https://github.com/RooCodeInc/Roo-Code/blob/main/LICENSE) |
| 136 | + |
| 137 | +--- |
| 138 | + |
| 139 | +**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! |
0 commit comments