Roo Code 3.22 Release Notes
This major release introduces 1-click task sharing, global rule directories, free Gemini access, enhanced mode discovery, and comprehensive bug fixes for memory leaks and provider integration.
1-Click Task Sharing

We've added the ability to share your Roo Code tasks publicly right from within the extension (learn more):
- Public Sharing: Select "Share Publicly" to generate a shareable link that anyone can access
- Automatic Clipboard Copy: Generated links are automatically copied to your clipboard for easy sharing
- Collaboration Ready: Share tasks with team members, collaborators, or anyone who needs to view your task and conversation history
Global Rules Directory Support
We've added support for cross-workspace custom instruction sharing through global directory loading (thanks samhvw8!) (#5016):
- Global Rules: Store rules in
~/.roo/rules/
for consistent configuration across all projects - Project-Specific Rules: Use
.roo/rules/
directories for project-specific customizations - Hierarchical Loading: Global rules load first, with project rules taking precedence for overrides
- Team Collaboration: Version-control project rules to share team standards and workflows
This enables configuration management across projects and machines, perfect for organizational onboarding and maintaining consistent development environments. Learn how to set up global rules.
Gemini CLI Provider (Free Access)
We've added a new Gemini CLI provider that enables free access to Google's Gemini models without requiring API keys:
- OAuth Authentication: Sign in with your Google account to access Gemini models at no cost
- Automatic Project Discovery: Seamlessly connects to your Google Cloud projects
- Streaming Responses: Real-time response streaming for better interactivity
- Complete Integration: Full UI support with comprehensive setup guidance
This gives you another powerful free option alongside local models and other free providers.
QOL Improvements
- Timer-Based Auto-Approval for Follow-Up Questions: Streamline your workflow with timer-based auto-approval for follow-up questions (learn more). (thanks liwilliam2021!) (#5296)
- Import and Export Custom Modes: Easily share, back up, and synchronize your custom modes across different projects and installations (learn more). (#5074)
- Enhanced Search and Indexing Controls:
- Configurable Search Score Threshold: Fine-tune the sensitivity of semantic search with a new slider in the settings (learn more). (#5041)
- Persistent Version Indicator: The Roo Code version is now always visible on the chat screen, providing a convenient way to check your version and access release notes without having to navigate to the settings. (#5128)
- Automatic Configuration Import: You can now automatically import your Roo Code configuration on startup by placing a config file at a specified path in your VSCode settings. This eliminates the need to manually import configurations through the GUI (learn more). (thanks takakoutso!) (#4848)
- Architect Mode Enhancements: To encourage better project planning, Architect mode is now the default for new installations. The mode has also been improved to no longer provide time estimates, ensuring its plans are focused on actionable steps rather than potentially misleading timelines (#5289, #5295).
- Mermaid Diagram Enhancements: Mermaid diagrams now have a cleaner and more consistent appearance. Toolbar buttons are now clearly visible in light mode, and distracting error messages will no longer be rendered on invalid diagrams, providing a smoother experience when creating and viewing diagrams. (thanks chrarnoldus!) (#5342, #5308)
- Improved Model Behavior: Models now provide more reliable and consistent responses. Previously, token usage information was unintentionally sent to the model, which could cause it to stop tasks or shorten its answers. This information is no longer sent, ensuring models complete tasks based on your requirements, not their perceived token limits (thanks SannidhyaSah!) (#5312)
- Enhanced File Protection: The
.vscode
directory is now write-protected to prevent accidental changes to your editor configuration (#5347) - Qdrant Configuration: Improved the user experience when configuring a custom Qdrant server by preventing the URL field from auto-filling with the default value. (thanks SannidhyaSah!) (#5217)
- Mode Discovery: Enhanced mode selector with highlighting for new users, redesigned interface, and descriptive text. Also moved the Roo Code Marketplace and Mode configuration buttons out of the top menu for better organization (thanks brunobergher!) (#4902)

- Quick Fix Control: Added setting to disable Roo Code quick fixes, preventing conflicts with other extensions (thanks OlegOAndreev!) (#4878) - Learn more

- Mode Switching: Follow-up question suggestions can now switch modes directly, eliminating the need to manually change modes after selecting a suggestion (#5200)
- Consistent Tooltips: Standardized tooltip delays to 300ms across the entire application for smooth, predictable behavior (#5098)
- Cost Transparency: Improved OpenRouter BYOK cost calculation accuracy using official upstream costs and restored cached token count visibility (#5145)
Security Fixes
- Code Display: Eliminated XSS vulnerability in code block rendering for enhanced security (thanks KJ7LNW!) (#5157)
Bug Fixes
- Inconsistent Cancellation Messages: Fixed an issue where canceling a task would show a misleading "API Streaming Failed" error. Now, canceling at any stage of a task will correctly display the "API Request Cancelled" message (#4904)
- Invalid Bedrock Model Identifier: Fixed an issue that caused "invalid model identifier" errors when using AWS Bedrock with cross-region inference. Users can now reliably connect to Bedrock models across different regions. (thanks KevinZhao, zenithfull!) (#4973)
- URL Loading Timeouts: Fixed an issue where referencing URLs with @ could result in a "Navigation timeout" error, making it more reliable to reference content from slower websites. (thanks MuriloFP, mrw1986!) (#5160)
- Excessive API Retry Delays: Fixed an issue where the auto-retry delay for failed API requests could become excessively long. The delay is now capped at 10 minutes, preventing tasks from getting stuck for extended periods. (thanks MuriloFP, piisawheel!) (#5171)
- Context Condensation Threshold: Fixed a bug where the context condensation threshold was not being applied correctly for individual profiles. Context will now be condensed at the specified threshold for each profile, as expected. (thanks PaperBoardOfficial!) (#5230)
apply_diff
Tool Documentation: Updated the documentation for theapply_diff
tool to correctly reflect its ability to apply edits to multiple files in a single operation. (thanks KJ7LNW!) (#5232)- Cache Files in System Prompt: Fixed an issue where cache files (like
.DS_Store
on macOS) were being included in the system prompt when using custom mode rules. This improves prompt quality and reduces unwanted noise. (thanks MuriloFP, juliettefournier-econ!) (#5283)
Provider Updates
- AWS Bedrock: Updated cross-region inference profile mapping for improved regional support (thanks KevinZhao!) (#4973)
- LiteLLM: Added default headers and testing for litellm fetcher, enhancing compatibility (thanks andrewshu2000!) (#5242)
- Gemini CLI Removal: The Gemini CLI provider has been removed per Google's request for a more standard implementation. Users previously using the Gemini CLI provider should migrate to the standard Gemini provider for continued access to Gemini models (#5223)
- Claude Code: Fixed token counting issues, message handling for long tasks, removed misleading UI controls, and improved caching/image upload (#5108, #5072, #5105, #5113)
- Azure OpenAI: Fixed compatibility with reasoning models by removing unsupported temperature parameter (thanks ExactDoug!) (#5116)
- AWS Bedrock: Improved throttling error detection and retry functionality (#4748)
Misc Improvements
- Installation Experience: Streamlined the process for developers to test local builds of the Roo Code extension. A new
pnpm install:vsix
command now automates uninstalling, building, and installing development versions, making it faster and easier to contribute (thanks devxpain!) (#4284) - VSCode Command Integration: Added programmatic settings import capability - import settings via Command Palette ("Roo: Import Settings") or VSCode API for automation (thanks shivamd1810!) (#5095)
- Translation Workflow: Improved internal translation processes to reduce file reads and improve efficiency (thanks KJ7LNW!) (#5126)
- YAML Parsing: Enhanced custom modes configuration handling for edge cases and special characters (#5099)