Home Explore Help
Sign In
AI
/
Roo-Code
mirror of https://github.com/RooCodeInc/Roo-Code.git
2
0
Fork 0
Files Issues 0 Wiki

Roo Code gives you a whole dev team of AI agents in your code editor.

Tree: a33117a83f
Branches Tags
Roo-Code
Chris Estreich a33117a83f Some cleanup in ExtensionHost (#10600) 1 week ago
.changeset 1e62b5ddf1 Changeset version bump (#10596) 1 week ago
.github c37aa02b21 chore: remove human-relay provider (#10388) 3 weeks ago
.husky 37ac53ed4a fix: prevent shell injection in pre-push hook environment loading (#9059) 2 months ago
.roo 237fa89b7e Add some slash commands that are useful for cli development (#10586) 1 week ago
.vscode 4b2b05f262 Rate limit when starting a subtask (#4453) 7 months ago
apps a33117a83f Some cleanup in ExtensionHost (#10600) 1 week ago
locales 0e9a765662 docs: Replace Todo Lists video with Context Management video (#10375) 3 weeks ago
packages a33117a83f Some cleanup in ExtensionHost (#10600) 1 week ago
releases f84beade7a Release v3.39.0 (#10537) 2 weeks ago
scripts ee9b255176 docs: remove Contributors section from README files (#9198) 2 months ago
src 1e62b5ddf1 Changeset version bump (#10596) 1 week ago
webview-ui 108f78db6c feat: add debug setting to settings page (#10580) 1 week ago
.dockerignore 424bce6078 Add an option to use our cli for evals (#10456) 2 weeks ago
.env.sample 532728ee85 Expose thinking tokens for `roo/sonic` (#7212) 5 months ago
.git-blame-ignore-revs 7368fa9288 Moved repo to new org (#3756) 8 months ago
.gitattributes 6fd261d3b6 feat: mark non-English package.nls.*.json files as linguist-generated (#7271) 5 months ago
.gitconfig b158f379eb Set up ignoring revisions for git blame 1 year ago
.gitignore e8ed344b0f Allow the cli release script to install locally for testing (#10597) 1 week ago
.nvmrc 7cd89edaa4 Upgrade Node.js to v20.19.2 for security enhancements (#4212) 7 months ago
.prettierrc.json ed24f65b30 Fix Posthog by correctly copying .env in the build process (#4049) 7 months ago
.rooignore 50f76584bc Add telemetry and privacy policy 10 months ago
.roomodes c8d1a9d699 Normalize docs-extractor audience tags; remove admin/stakeholder; strip tool invocations (#8717) 3 months ago
.tool-versions 7e0354d531 chore(deps): update node.js to v20.19.2 (#4159) 7 months ago
CHANGELOG.md 1e62b5ddf1 Changeset version bump (#10596) 1 week ago
CODE_OF_CONDUCT.md d67b351fca Fix inconsistencies in markdown file i18n (#4681) 7 months ago
CONTRIBUTING.md ee58c5d0fa CONTRIBUTING.md tweaks and issue template rewrite (#8014) 4 months ago
LICENSE 5ef0a6a8ce Update LICENSE (#2275) 9 months ago
PRIVACY.md 33fe6fb9c6 Make Posthog telemetry the default (#7909) 4 months ago
README.md 0e9a765662 docs: Replace Todo Lists video with Context Management video (#10375) 3 weeks ago
SECURITY.md 39f69f27ef Create SECURITY.md 7 months ago
ellipsis.yaml d6d43b24f4 Revert "Turn off ellipsis quiet mode" 10 months ago
knip.json ee93530076 Browser Use 2.0 (#8941) 2 months ago
package.json 3171ffc809 Move more types to @roo-code/types (for the cli) (#10583) 1 week ago
pnpm-lock.yaml a33117a83f Some cleanup in ExtensionHost (#10600) 1 week ago
pnpm-workspace.yaml 3beeac6f58 Remove the "test" custom tools (#10255) 1 month ago
renovate.json 02b4414d7d Ignore @vscode/vsce in renovate (#4170) 7 months ago
tsconfig.json c56b95bc60 Task metadata (#7092) 5 months ago
turbo.json 73f39616c3 Improve turbo task dependency declarations (#4323) 7 months ago

README.md

VS Code Marketplace X YouTube Join Discord Join r/RooCode

Get help fast → Join Discord • Prefer async? → Join r/RooCode

Roo Code

Your AI-Powered Dev Team, Right in Your Editor

🌐 Available languages - [English](README.md) - [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) - ...

What Can Roo Code Do For YOU?

  • Generate Code from natural language descriptions and specs
  • Adapt with Modes: Code, Architect, Ask, Debug, and Custom Modes
  • Refactor & Debug existing code
  • Write & Update documentation
  • Answer Questions about your codebase
  • Automate repetitive tasks
  • Utilize MCP Servers

Modes

Roo Code adapts to how you work:

  • Code Mode: everyday coding, edits, and file ops
  • Architect Mode: plan systems, specs, and migrations
  • Ask Mode: fast answers, explanations, and docs
  • Debug Mode: trace issues, add logs, isolate root causes
  • Custom Modes: build specialized modes for your team or workflow
  • Roomote Control: Roomote Control lets you remotely control tasks running in your local VS Code instance.

Learn more: Using Modes • Custom Modes • Roomote Control

Tutorial & Feature Videos

Installing Roo Code
Configuring Profiles
Codebase Indexing

Custom Modes
Checkpoints
Context Management

More quick tutorial and feature videos...

Resources

Local Setup & Development

  1. Clone the repo:

    git clone https://github.com/RooCodeInc/Roo-Code.git

  2. Install dependencies:

    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:

pnpm install:vsix [-y] [--editor=<command>]

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=<command>: 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:

    pnpm vsix

  2. A .vsix file will be generated in the bin/ directory (e.g., bin/roo-cline-<version>.vsix).

  3. Install it manually using the VSCode CLI:

    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 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.

License

Apache 2.0 © 2025 Roo Code, Inc.

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 or Discord. Happy coding!