Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 3 additions & 13 deletions docs/features/code-actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,8 @@ Clicking the lightbulb, right-clicking and selecting "Roo Code", or using the ke

Roo Code provides the following Code Actions:

* **Add to Context:** Quickly adds the selected code to your chat with Roo, including line numbers so Roo knows exactly where the code is from. It's listed first in the menu for easy access. (More details below).
* **Add to Context:** Quickly adds the selected code to your chat with Roo, including the filename and line numbers so Roo knows exactly where the code is from. It's listed first in the menu for easy access.
* **Explain Code:** Asks Roo Code to explain the selected code.
* **Fix Code:** Asks Roo Code to fix problems in the selected code (available when diagnostics are present).
* **Improve Code:** Asks Roo Code to suggest improvements to the selected code.

### Add to Context Deep Dive
Expand All @@ -36,8 +35,6 @@ Can you explain this function?

*(Where `@myFile.js:15:25` represents the code added via "Add to Context")*

Each of these actions can be performed "in a new task" or "in the current task."

## Using Code Actions

There are three main ways to use Roo Code's Code Actions:
Expand All @@ -62,22 +59,15 @@ There are three main ways to use Roo Code's Code Actions:

1. **Select Code:** Select the code you want to work with.
2. **Open the Command Palette:** Press `Ctrl+Shift+P` (Windows/Linux) or `Cmd+Shift+P` (macOS).
3. **Type a Command:** Type "Roo Code" to filter the commands, then choose the relevant code action (e.g., "Roo Code: Explain Code"). You can also type the start of the command, like "Roo Code: Explain", and select from the filtered list.
3. **Type a Command:** Type "Roo Code" to filter the commands, then choose the relevant code action (e.g., "Roo Code: Explain Code"). The action will apply in the most logical context (usually the current active chat task, if one exists).
4. **Review and Approve:** Roo Code will propose a solution in the chat panel. Review the proposed changes and approve or reject them.

## Code Actions and Current Task

Each code action gives you two options:

* **in New Task:** Select this to begin a conversation with Roo centered around this code action.
* **in Current Task:** If a conversation has already begun, this option will add the code action as an additional message.

## Customizing Code Action Prompts

You can customize the prompts used for each Code Action by modifying the "Support Prompts" in the **Prompts** tab. This allows you to fine-tune the instructions given to the AI model and tailor the responses to your specific needs.

1. **Open the Prompts Tab:** Click the <Codicon name="notebook" /> icon in the Roo Code top menu bar.
2. **Find "Support Prompts":** You will see the support prompts, including "Enhance Prompt", "Explain Code", "Fix Code", and "Improve Code".
2. **Find "Support Prompts":** You will see the support prompts, including "Enhance Prompt", "Explain Code", and "Improve Code".
3. **Edit the Prompts:** Modify the text in the text area for the prompt you want to customize. You can use placeholders like `${filePath}` and `${selectedText}` to include information about the current file and selection.
4. **Click "Done":** Save your changes.

Expand Down
12 changes: 12 additions & 0 deletions docs/features/shell-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,9 @@ Shell integration is automatically enabled in Roo Code and connects directly to
- Observe command exit codes to determine success or failure
- Track working directory changes as you navigate your project
- React intelligently to terminal output without user intervention
- Stop running commands directly from the chat interface using the stop button that appears next to the command execution message.

<img src="/img/v3.15/v3.15.png" alt="Stop Command Button in Chat UI" width="600" />
When you ask Roo to perform tasks like installing dependencies, starting a development server, or analyzing build errors, shell integration works behind the scenes to make these interactions smooth and effective.

## Troubleshooting Shell Integration
Expand All @@ -25,6 +27,16 @@ Shell integration is built into Roo Code and works automatically in most cases.
4. **WSL users**: Add `. "$(code --locate-shell-integration-path bash)"` to your `~/.bashrc`

## Terminal Integration Settings
### Command Execution Fallback

Roo Code includes a fallback mechanism to ensure commands can still run even if VSCode's native shell integration fails or is unavailable.

- **How it works**: If Roo Code cannot connect to the terminal using standard shell integration, it will automatically attempt to execute the command directly using a background process.
- **Notification**: You'll see a notification in the chat if this fallback is used, indicating that the command is running without full shell integration features (like real-time output streaming or exit code detection might be limited).
- **Resolution**: The notification will include links to help you troubleshoot the underlying shell integration issue if you wish to restore full functionality. Often, following the steps in this document resolves the problem.

<img src="/img/v3.15.0/v3.15.0.png" alt="Stop Command Button in Chat UI" width="600" />


Roo Code provides several settings to fine-tune shell integration. Access these in the Roo Code sidebar under Settings → Terminal.

Expand Down
2 changes: 2 additions & 0 deletions docs/update-notes/index.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
- [3.15](/update-notes/v3.15) (2025-04-30)
* [3.15.1](/update-notes/v3.15.1) (2025-04-30)
* [3.15.0](/update-notes/v3.15.0) (2025-04-30)
# Update Notes

This section contains notes about recent updates to Roo Code, listed by version number.
Expand Down
49 changes: 49 additions & 0 deletions docs/update-notes/v3.15.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Roo Code 3.15.0 Release Notes (2025-04-30)

This release introduces prompt caching for Google Vertex, improved terminal command handling, UI/UX enhancements, and several other improvements and bug fixes.

## Prompt Caching for Google Vertex

* Added prompt caching capabilities to the Google Vertex provider for potentially faster and more cost-effective responses (thanks ashktn).

## Improved Terminal Command Handling

* Implemented a [fallback mechanism](/features/shell-integration#command-execution-fallback) for executing terminal commands if VSCode terminal shell integration fails.
* Added the ability to stop commands directly from the chat UI.

<img src="/img/v3.15.0/v3.15.0-2.png" width="600" />

## Settings Import/Export

* Roo Code settings can now be imported directly from the welcome screen (thanks julionav).

<img src="/img/v3.15.0/v3.15.0-1.png" width="600" />

* Fixed importing & exporting of custom modes (thanks julionav).

## QOL Improvements

* Improved the UI/UX of code snippets in the chat (thanks KJ7LNW).
* Adjusted chat view padding to accommodate small width layouts (thanks zhangtony239).
* Simplified and streamlined Roo Code's [quick actions](/features/code-actions).

<img src="/img/v3.15/v3.15-1.png" width="350" />
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: The image source on line 30 uses '/img/v3.15/v3.15-1.png'. Consider changing it to '/img/v3.15.0/v3.15.0-1.png' for consistency with the rest of the release notes.

Suggested change
<img src="/img/v3.15/v3.15-1.png" width="350" />
<img src="/img/v3.15.0/v3.15.0-1.png" width="350" />


* Improved the auto-approve toggle buttons for some high-contrast VSCode themes.
* Offloaded expensive count token operations to a web worker for better performance (thanks samhvw8).
* Improved support for multi-root workspaces (thanks snoyiatk).
* Improved the performance of mode switching (thanks dlab-anton).

## Bug Fixes

* Fixed file mentions for filenames containing spaces.
* Fixed importing & exporting of custom modes (thanks julionav).

## Provider Updates

* **Google Vertex:** Added prompt caching (thanks ashktn).
* **OpenAI Compatible:** Added a reasoning effort setting (thanks mr-ryan-james).

## Misc Improvements

* Removed unused types (thanks wkordalski).
13 changes: 13 additions & 0 deletions docs/update-notes/v3.15.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Roo Code 3.15.1 Release Notes (2025-04-30)

This patch release includes several bug fixes and quality-of-life improvements.

## Bug Fixes

* Made retries respect the global auto-approve checkbox.
* Fixed a selection mode bug in the history view (thanks jr!).
* Fixed the new intigrated terminal to capture stderr in execa-spawned processes.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "intigrated" should be "integrated".

Suggested change
* Fixed the new intigrated terminal to capture stderr in execa-spawned processes.
* Fixed the new integrated terminal to capture stderr in execa-spawned processes.


## QOL Improvements

* Play notification sound (when enabled) only when action is needed from the user (thanks olearycrew!).
12 changes: 10 additions & 2 deletions docs/update-notes/v3.15.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,26 +8,34 @@ This release introduces prompt caching for Google Vertex, improved terminal comm

## Improved Terminal Command Handling

* Implemented a fallback mechanism for executing terminal commands if VSCode terminal shell integration fails.
* Implemented a [fallback mechanism](/features/shell-integration#command-execution-fallback) for executing terminal commands if VSCode terminal shell integration fails.
* Added the ability to stop commands directly from the chat UI.

<img src="/img/v3.15.0/v3.15.0-2.png" width="600" />

## Settings Import/Export

* Roo Code settings can now be imported directly from the welcome screen (thanks julionav).
* Fixed importing & exporting of custom modes (thanks julionav).

## QOL Improvements

* Play notification sound (when enabled) only when action is needed from the user (thanks olearycrew!).
* Improved the UI/UX of code snippets in the chat (thanks KJ7LNW).
* Adjusted chat view padding to accommodate small width layouts (thanks zhangtony239).
* Simplified and streamlined Roo Code's quick actions.
* Simplified and streamlined Roo Code's [quick actions](/features/code-actions).

<img src="/img/v3.15/v3.15-1.png" width="350" />

* Improved the auto-approve toggle buttons for some high-contrast VSCode themes.
* Offloaded expensive count token operations to a web worker for better performance (thanks samhvw8).
* Improved support for multi-root workspaces (thanks snoyiatk).
* Improved the performance of mode switching (thanks dlab-anton).

## Bug Fixes

* Made retries respect the global auto-approve checkbox.
* Fixed a selection mode bug in the history view (thanks jr!).
* Fixed file mentions for filenames containing spaces.
* Fixed importing & exporting of custom modes (thanks julionav).

Expand Down
8 changes: 5 additions & 3 deletions sidebars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -171,15 +171,17 @@ const sidebars: SidebarsConfig = {
label: '3.15',
items: [
{ type: 'doc', id: 'update-notes/v3.15', label: '3.15 Combined' },
{ type: 'doc', id: 'update-notes/v3.15.1', label: '3.15.1' },
{ type: 'doc', id: 'update-notes/v3.15.0', label: '3.15.0' },
],
},
{
type: 'category',
label: '3.14',
items: [
{ type: 'doc', id: 'update-notes/v3.14', label: '3.14 Combined' },
{ type: 'doc', id: 'update-notes/v3.14.3', label: '3.14.3' },
{ type: 'doc', id: 'update-notes/v3.14.2', label: '3.14.2' },
{ type: 'doc', id: 'update-notes/v3.14', label: '3.14 Combined' },
{ type: 'doc', id: 'update-notes/v3.14.3', label: '3.14.3' },
{ type: 'doc', id: 'update-notes/v3.14.2', label: '3.14.2' },
{ type: 'doc', id: 'update-notes/v3.14.1', label: '3.14.1' },
{ type: 'doc', id: 'update-notes/v3.14.0', label: '3.14.0' },
],
Expand Down
Binary file added static/img/v3.15.0/v3.15.0-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/v3.15.0/v3.15.0-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/v3.15.0/v3.15.0.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/v3.15/v3.15-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/v3.15/v3.15.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.