Roo-Code/jetbrains

Roo Code for JetBrains IDEs

This directory contains the integration of Roo Code with RunVSAgent, enabling Roo Code to run seamlessly in JetBrains IDEs (IntelliJ IDEA, WebStorm, PyCharm, etc.).

🎯 Overview

RunVSAgent acts as a bridge between VSCode extensions and JetBrains IDEs, allowing you to use Roo Code's AI-powered development features in your favorite JetBrains IDE.

🚀 Quick Start

Prerequisites

• Node.js 18.0+
• JDK 17+
• JetBrains IDE 2023.1+
• Git

Building

# From the project root
cd jetbrains
./build.sh

This will:

1. Update the RunVSAgent submodule
2. Build the Roo Code extension
3. Package everything for JetBrains
4. Create dist/RunVSAgent-RooCode.zip

Installation

1. Open your JetBrains IDE
2. Go to Settings/Preferences → Plugins
3. Click the gear icon ⚙️ → Install Plugin from Disk...
4. Select jetbrains/dist/RunVSAgent-RooCode.zip
5. Restart your IDE

📁 Project Structure

jetbrains/
├── RunVSAgent/           # RunVSAgent submodule
│   ├── extension_host/   # Node.js runtime for VSCode APIs
│   ├── jetbrains_plugin/ # Kotlin-based JetBrains plugin
│   └── deps/
│       └── roo-code/    # Roo Code extension files
├── build.sh             # Main build script
├── build-dev.sh         # Development build (faster)
├── README.md            # This file
└── dist/                # Build output directory

🔧 Development

For development, use the faster dev build:

./build-dev.sh

This skips some optimization steps for quicker iteration.

Debugging

1. Extension Host Logs: Check the IDE logs for Node.js runtime issues
2. Plugin Logs: Look in Help → Show Log in Finder/Explorer
3. Enable Debug Mode: Set VSCODE_DEBUG=true in environment

🏗️ Architecture

graph LR
    A[JetBrains IDE] --> B[RunVSAgent Plugin]
    B --> C[RPC Socket]
    C --> D[Node.js Extension Host]
    D --> E[VSCode API Layer]
    E --> F[Roo Code Extension]

🤝 How It Works

1. RunVSAgent Plugin runs in the JetBrains IDE (Kotlin)
2. Extension Host provides VSCode-compatible APIs (Node.js)
3. RPC Communication bridges the two environments
4. Roo Code runs unmodified using VSCode APIs

⚙️ Configuration

After installation, configure Roo Code:

1. Open RunVSAgent panel in your IDE
2. Select "Roo Code" from available agents
3. Configure API keys and settings
4. Start using AI-powered development features

🐛 Troubleshooting

Plugin doesn't load

• Ensure JetBrains IDE version ≥ 2023.1
• Check if JCEF is enabled (required for WebView)
• For Android Studio, enable JCEF manually

Node.js not found

• Verify Node.js is in PATH: node --version
• Restart IDE after installing Node.js

Extension not activating

• Check extension host logs
• Verify deps/roo-code/ contains extension files
• Rebuild with ./build.sh

📚 Resources

• RunVSAgent Documentation
• Roo Code Documentation
• JetBrains Plugin Development

📄 License

This integration follows the licenses of both projects:

• Roo Code: Check main repository
• RunVSAgent: Apache License 2.0