Roo-Code/README.md
Chris Estreich 4f683b5e8e
Parallel tasks (#2128)
* Parallel tasks

* Handle null [x]ModelInfo types, recover from settings schema parse errors (#2064)

* Require exactly node v20.18.1 (#2065)

* Get rid of runner and all CJS stuff

* Add an activation command for other extensions (#2073)

Since VS Code provides no actionEvents that trigger when a specific
extension activates, extensions can't activate only once Roo is
activated and ready.

This commit introduces a new roo-cline.activationCompleted command
and fires it at the very end of extension activation. Other
extensions that use Roo's exported APIs can now activate when they
see this event.

Co-authored-by: Greg Taylor <gregtaylor@netflix.com>

* Update bug_report.yml (#1994)

* Update bug_report.yml

* Update bug_report.yml

---------

Co-authored-by: Matt Rubens <mrubens@users.noreply.github.com>

* Fix mention file name is not fully displayed (#2026)

Fixed path leading character handling to preserve language characters and remove specific punctuation marks

* In-Editor Browser Improvements (#1601)

* Browser Automation Improvements
* Added multi-tab remote Chrome support
* Added support for hover
* Properly caching remote browser host in global state
* Cleanup functions

* Updated for changes after merge

* Added www. exception for common tabs

* Update src/core/webview/ClineProvider.ts

* Revert README changes

---------

Co-authored-by: Matt Rubens <mrubens@users.noreply.github.com>

* Add missing awaits on refactored tools (#2078)

* More progress

* Added Gemini 2.5 Pro model to GCP Vertex AI Provider (#2079)

* More progress

* Display info about partial reads in chat row (#2080)

* More progress

* Update contributors list (#2023)

docs: update contributors list [skip ci]

Co-authored-by: mrubens <mrubens@users.noreply.github.com>

* More progress

* Handle multiple API pages worth of contributors (#2088)

* Update contributors list (#2089)

docs: update contributors list [skip ci]

Co-authored-by: mrubens <mrubens@users.noreply.github.com>

* Refactor/cline.ts/list files (#2067)

* "Refactor list_files tool to separate module (#2057)"

* Await

---------

Co-authored-by: Matt Rubens <mrubens@users.noreply.github.com>

* Remove switch from tools (#2091)

* HandleError returns a promise

* Remove unnecessary switch from tools

* Fix a type in the listFiles tool (#2092)

* Move write_to_file to a tool file (#2093)

* Move apply_diff to a tool file (#2094)

* Move insert_content to a tool file (#2095)

* Move search_and_replace to a tool file (#2096)

* Move list_code_definition_names to a tool file (#2097)

* Move search_files to a tool file (#2098)

* Move browser_action to a tool file (#2099)

* Move execute_command to a tool file (#2100)

* Move use_mcp_tool and access_mcp_resource to tool files (#2101)

* Move new_task, switch_mode, attempt_completion, and ask_followup_question to tool files (#2102)

* Do a little code cleanup now that tools are refactored out (#2103)

* Clean up the way we compute the current diff strategy (#2049)

* Clean up the way we compute the current diff strategy

* Add changeset

* i18n Add translations for task pinning and unpinning (#2109)

Signed-off-by: feifei <liuyansheng1121@gmail.com>

* Remove the ask promise error (#2107)

* Remove the ask promise error

* Send start_time along with checkpoints and use it to position in the messages

* Link to the settings page from the auto approve toolbar (#2111)

* Link to provider docs from the API options (#2112)

* Revert "Remove the ask promise error" (#2117)

Revert "Remove the ask promise error (#2107)"

This reverts commit 712ca71ee0.

* Parse the retry out of the gemini 429 response (#2118)

* Fix Gemini command escaping (#2120)

* Fix switching profiles to ensure only the selected profile is switche… (#2119)

Fix switching profiles to ensure only the selected profile is switched for all modes, and optimize certain i18n keys.

Signed-off-by: feifei <liuyansheng1121@gmail.com>

* Tweaks to support prompt line number format (#2121)

* Remove the ask promise error (#2123)

* Stronger typing

* Added Gemini 2.5 Pro model to GCP Vertex AI Provider (#2079)

* Display info about partial reads in chat row (#2080)

* Update contributors list (#2023)

docs: update contributors list [skip ci]

Co-authored-by: mrubens <mrubens@users.noreply.github.com>

* Handle multiple API pages worth of contributors (#2088)

* Update contributors list (#2089)

docs: update contributors list [skip ci]

Co-authored-by: mrubens <mrubens@users.noreply.github.com>

* Refactor/cline.ts/list files (#2067)

* "Refactor list_files tool to separate module (#2057)"

* Await

---------

Co-authored-by: Matt Rubens <mrubens@users.noreply.github.com>

* Remove switch from tools (#2091)

* HandleError returns a promise

* Remove unnecessary switch from tools

* Fix a type in the listFiles tool (#2092)

* Move write_to_file to a tool file (#2093)

* Move apply_diff to a tool file (#2094)

* Move insert_content to a tool file (#2095)

* Move search_and_replace to a tool file (#2096)

* Move list_code_definition_names to a tool file (#2097)

* Move search_files to a tool file (#2098)

* Move browser_action to a tool file (#2099)

* Move execute_command to a tool file (#2100)

* Move use_mcp_tool and access_mcp_resource to tool files (#2101)

* Move new_task, switch_mode, attempt_completion, and ask_followup_question to tool files (#2102)

* Do a little code cleanup now that tools are refactored out (#2103)

* Clean up the way we compute the current diff strategy (#2049)

* Clean up the way we compute the current diff strategy

* Add changeset

* i18n Add translations for task pinning and unpinning (#2109)

Signed-off-by: feifei <liuyansheng1121@gmail.com>

* Remove the ask promise error (#2107)

* Remove the ask promise error

* Send start_time along with checkpoints and use it to position in the messages

* Link to the settings page from the auto approve toolbar (#2111)

* Link to provider docs from the API options (#2112)

* Revert "Remove the ask promise error" (#2117)

Revert "Remove the ask promise error (#2107)"

This reverts commit 712ca71ee0.

* Parse the retry out of the gemini 429 response (#2118)

* Fix Gemini command escaping (#2120)

* Fix switching profiles to ensure only the selected profile is switche… (#2119)

Fix switching profiles to ensure only the selected profile is switched for all modes, and optimize certain i18n keys.

Signed-off-by: feifei <liuyansheng1121@gmail.com>

* Tweaks to support prompt line number format (#2121)

* Remove the ask promise error (#2123)

* Pass along pid and ppid

* Revert "Remove the ask promise error" (#2126)

Revert "Remove the ask promise error (#2123)"

This reverts commit b788aa1ec4.

---------

Signed-off-by: feifei <liuyansheng1121@gmail.com>
Co-authored-by: Greg Taylor <gtaylor@users.noreply.github.com>
Co-authored-by: Greg Taylor <gregtaylor@netflix.com>
Co-authored-by: Hannes Rudolph <hrudolph@gmail.com>
Co-authored-by: Matt Rubens <mrubens@users.noreply.github.com>
Co-authored-by: aheizi <aheizi@outlook.com>
Co-authored-by: Afshawn Lotfi <6283745+afshawnlotfi@users.noreply.github.com>
Co-authored-by: Nico Bihan <nicolas.bihan@wellsky.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Bhavesh Ramburn <nitrogen@gmail.com>
Co-authored-by: feifei <46489071+feifei325@users.noreply.github.com>
2025-03-30 15:09:26 -07:00

32 KiB
Raw Blame History


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 youre 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 for detailed updates and fixes.


🎉 Roo Code 3.10 Released

Roo Code 3.10 brings powerful productivity enhancements!

  • Suggested responses to questions to save you time typing
  • Improved large file handling through mapping out the file structure and reading only the relevant content
  • Rebuilt @-mention file lookup that respects .gitignore and doesn't have a limit on the number of files tracked

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
  2. Connect Your AI Provider
  3. Try Your First Task

Key Features

Multiple Modes

Roo Code adapts to your needs with specialized 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: Create unlimited specialized personas for security auditing, performance optimization, documentation, or any other task

Smart Tools

Roo Code comes with powerful tools 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)

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:

Resources

Documentation

Community


Local Setup & Development

  1. Clone the repo:
git clone https://github.com/RooVetGit/Roo-Code.git
  1. Install dependencies:
npm run install:all
  1. Start the webview (Vite/React app with HMR):
npm run dev
  1. Debug: Press F5 (or RunStart 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:

npm run build

A .vsix file will appear in the bin/ directory which can be installed with:

code --install-extension bin/roo-cline-<version>.vsix

We use changesets for versioning and publishing. Check our CHANGELOG.md for release notes.


Disclaimer

Please note that Roo Veterinary, 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.


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
nissa-seru
nissa-seru
jquanton
jquanton
hannesrudolph
hannesrudolph
NyxJae
NyxJae
MuriloFP
MuriloFP
punkpeye
punkpeye
d-oit
d-oit
monotykamary
monotykamary
cannuri
cannuri
lloydchang
lloydchang
vigneshsubbiah16
vigneshsubbiah16
KJ7LNW
KJ7LNW
Szpadel
Szpadel
lupuletic
lupuletic
feifei325
feifei325
qdaxb
qdaxb
wkordalski
wkordalski
Smartsheet-JB-Brown
Smartsheet-JB-Brown
Premshay
Premshay
psv2522
psv2522
olweraltuve
olweraltuve
RaySinner
RaySinner
aheizi
aheizi
afshawnlotfi
afshawnlotfi
diarmidmackenzie
diarmidmackenzie
emshvac
emshvac
pdecat
pdecat
pugazhendhi-m
pugazhendhi-m
Lunchb0ne
Lunchb0ne
sammcj
sammcj
dtrugman
dtrugman
aitoroses
aitoroses
yt3trees
yt3trees
yongjer
yongjer
vincentsong
vincentsong
teddyOOXX
teddyOOXX
eonghk
eonghk
arthurauffray
arthurauffray
heyseth
heyseth
philfung
philfung
napter
napter
mdp
mdp
Chenjiayuan195
Chenjiayuan195
jcbdev
jcbdev
GitlyHallows
GitlyHallows
benzntech
benzntech
anton-otee
anton-otee
lightrabbit
lightrabbit
kohii
kohii
kinandan
kinandan
jwcraig
jwcraig
im47cn
im47cn
dqroid
dqroid
dairui1
dairui1
bannzai
bannzai
ashktn
ashktn
Yoshino-Yukitaro
Yoshino-Yukitaro
vladstudio
vladstudio
tgfjt
tgfjt
AMHesch
AMHesch
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
chadgauth
chadgauth
dleen
dleen
dbasclpy
dbasclpy
linegel
linegel
celestial-vault
celestial-vault
franekp
franekp
DeXtroTip
DeXtroTip
gtaylor
gtaylor
hesara
hesara
eltociear
eltociear
Jdo300
Jdo300
libertyteeth
libertyteeth
mamertofabian
mamertofabian
marvijo-code
marvijo-code
kvokka
kvokka
nbihan-mediware
nbihan-mediware
PeterDaveHello
PeterDaveHello
Sarke
Sarke
01Rian
01Rian
samsilveira
samsilveira
StevenTCramer
StevenTCramer
maekawataiki
maekawataiki

License

Apache 2.0 © 2025 Roo Veterinary, Inc.


Enjoy Roo Code! Whether you keep it on a short leash or let it roam autonomously, we cant wait to see what you build. If you have questions or feature ideas, drop by our Reddit community or Discord. Happy coding!