Skip to main content

Roo Code 3.25 Release Notes

This release brings powerful new capabilities to Roo Code, including custom slash commands for workflow automation, enhanced Gemini models with web access, comprehensive image support, seamless message queueing for uninterrupted conversations, the new Cerebras AI provider, and auto-approved cost limits for budget control.

Custom Slash Commands​

Create your own slash commands to automate repetitive workflows (#6263, #6286, #6333, #6336, #6327):

  • File-Based Commands: Place markdown files in .roo/commands/ to create custom commands instantly
  • Management UI: New interface for creating, editing, and deleting commands with built-in fuzzy search
  • Argument Hints: Commands display helpful hints about required arguments as you type
  • Rich Descriptions: Add metadata and descriptions to make commands self-documenting
Slash commands menu showing available commands

Turn complex workflows into simple commands like /deploy or /review for faster development.

📚 Documentation: See Slash Commands Guide for detailed usage instructions.

Message Queueing​

Continue typing while Roo processes your requests with the new message queueing system (#6167):

  • Non-Blocking Input: Type and send messages even while Roo is processing previous requests
  • Sequential Processing: Messages are queued and processed in the order they were sent
  • Visual Feedback: See queued messages clearly displayed in the interface
  • Maintained Context: Each message maintains proper context from the conversation

Keeps your workflow smooth when you have multiple quick questions or corrections.

📚 Documentation: See Message Queueing Guide for detailed information.

Image Support for read_file Tool​

The read_file tool now supports reading and analyzing images (thanks samhvw8!) (#5172):

  • Multiple Formats: Supports PNG, JPG, JPEG, GIF, WebP, SVG, BMP, ICO, and TIFF
  • OCR Capabilities: Extract text from screenshots and scanned documents
  • Batch Processing: Read multiple images from a folder with descriptions
  • Simple Integration: Works just like reading text files - no special configuration needed

Useful for analyzing UI mockups, debugging screenshot errors, or extracting code from images.

Gemini models can now access web content and perform Google searches for more accurate, up-to-date responses (thanks HahaBill!) (#5959):

  • URL Context: Directly analyze web pages, documentation, and online resources
  • Google Search Grounding: Get fact-checked responses based on current search results
  • User Control: Enable or disable web features based on your privacy preferences
  • Real-Time Information: Access the latest documentation and best practices

Perfect for researching new libraries, verifying solutions, or getting current API information.

📚 Documentation: See Gemini Provider Guide for setup and usage instructions.

Context-Aware Prompt Enhancement​

Prompt enhancement now uses your conversation history for better suggestions (thanks liwilliam2021!) (#6343):

  • Smarter Suggestions: Enhancement considers your last 10 messages to generate more relevant prompts
  • Reduced Hallucinations: Context awareness prevents the AI from making unfounded suggestions
  • Flexible Configuration: Use a separate API configuration for enhancement operations
  • Toggle Control: Enable or disable task history inclusion based on your needs

To enable this feature: Settings → Prompts tab → Select "ENHANCE" → Check "Include task history in enhancement" for better context.

📚 Documentation: See Prompt Enhancement Guide for configuration options.

Auto-approved Cost Limits​

We've introduced a new cost control feature in the auto-approve settings to help manage API spending:

  • Budget Protection: Set a maximum cost limit in your auto-approve settings to control total API spending
  • Automatic Prompting: Roo Code will prompt for approval when approaching your cost limit
  • Complements Request Limits: Works alongside existing request count limits for comprehensive control
Auto-approve settings showing the new Max Cost field

This feature provides peace of mind when using expensive models or running long sessions, ensuring you stay within budget. You can find this new "Max Cost" setting alongside the existing "Max Count" in the auto-approve configuration panel.

Quality of Life Improvements​

Small changes that make a big difference in your daily workflow:

  • Multi-Folder Workspace Support: Code indexing now works correctly across all folders in multi-folder workspaces
  • Checkpoint Timing: Checkpoints now save before file changes are made, allowing easy undo of unwanted modifications
  • Redesigned Task Header: Cleaner, more intuitive interface with improved visual hierarchy
  • Consistent Checkpoint Terminology: Removed "Initial Checkpoint" terminology for better consistency
  • Responsive Mode Dropdowns: Mode selection dropdowns now resize properly with the window
  • Performance Boost: Significantly improved performance when processing long AI responses
  • Cleaner Command Approval UI: Simplified interface shows only unique command patterns
  • Smart Todo List Reminder: Todo list reminder now respects configuration settings
  • Cleaner Task History: Improved task history display showing more content (3 lines), up to 5 tasks in preview, and simplified footer
  • Markdown Table Rendering: Tables now display with proper formatting instead of raw markdown for better readability (#6252) Markdown table rendering in Roo Code
  • Mode Selector Popover Redesign: Improved layout with search functionality when you have many modes installed (#6140) Mode Selector Popover with Search
  • API Selector Popover Redesign: Updated to match the new mode selector design with improved layout (#6148) API Configuration Selector Redesign
  • Auto-approve UI: Cleaner and more streamlined interface with improved localization
  • Sticky Task Modes: Tasks remember their last-used mode and restore it automatically (#6177)
  • ESC Key Support: Close popovers with ESC for better keyboard navigation (#6175)
  • Improved Command Highlighting: Only valid commands are highlighted in the input field (#6336)
  • Command Validation: Better handling of background execution (&) and subshell patterns like (cmd1; cmd2)
  • Subshell Validation: Improved handling and validation of complex shell commands with subshells, preventing potential errors when using command substitution patterns (#6379)
  • Slash Command Icon Hover State: Fixed the hover state for the slash command icon to provide better visual feedback during interactions (#6388)
  • Cleaner Welcome View: Gemini checkboxes are now hidden on the welcome screen for a cleaner interface (#6415)
  • Slash Commands Documentation: Added a direct link to slash commands documentation for easier access (#6409)
  • Documentation Updates: Clarified apply_diff tool descriptions to emphasize surgical edits (#6278)
  • Task Resumption Message: Improved LLM instructions by removing misleading message about resuming tasks (thanks KJ7LNW!) (#5851)
  • AGENTS.md Support: Added symlink support for AGENTS.md file loading (#6326)
  • Marketplace Updates: Auto-refresh marketplace data when organization settings change (#6446)

Bug Fixes​

Critical fixes that improve stability and compatibility:

  • Mode Name Validation: Prevents empty mode names from causing YAML parsing errors
  • Text Highlight Alignment: Fixed misalignment in chat input area highlights
  • MCP Server Setting: Properly respects the "Enable MCP Server Creation" setting
  • VB.NET Indexing: Files are now properly indexed in large monorepos using fallback chunking
  • Message Sending: Restored functionality when clicking the save button
  • Search/Replace Tolerance: More forgiving of AI-generated diffs with extra > characters
  • Qdrant Deletion: Gracefully handles deletion errors to prevent indexing interruption
  • LM Studio Context Length: Models now correctly display their actual context length instead of "1"
  • Claude Code Errors: ENOENT errors now show helpful installation guidance
  • Claude Code Error Handling: Fixed "spawn claude ENOENT" error when using Claude Code provider, now provides better error handling and installation guidance (thanks JamieJ1!)
  • Multi-file Edit Fix: Fixed issue where Git diff views interfered with file operations (thanks hassoncs, szermatt!) (#6350)
  • Non-QWERTY Keyboard Support: Fixed keyboard shortcuts for Dvorak, AZERTY, and other layouts (thanks shlgug!) (#6162)
  • Mode Export/Import: Fixed custom mode export to handle slug changes correctly (#6186)
  • Hidden Directory Support: list_files now properly shows contents of dot directories (thanks MuriloFP, avtc, zhang157686!) (#5176)
  • Scrollbar Stability: Fixed flickering scrollbar when streaming tables and code blocks (#6266)
  • Settings Link Fix: Restored working "View Settings" link in command permissions tooltip (#6253)
  • @mention Parsing: Fixed mentions to work in all input contexts including follow-up questions (#6331)
  • Debug Button Removal: Hidden test error boundary button in production builds (thanks bangjohn!) (#6216)
  • Command Highlighting Fix: Fixed inconsistent slash command highlighting behavior (#6325)
  • Text Wrapping: Fixed text overflow for long command patterns in permissions UI (#6255)
  • Cross-Platform Mode Export: Windows path separators now convert correctly for Unix systems (#6308)
  • Diff View Display: Fixed an issue where the diff view wasn't showing before approval when background edits were disabled (#6386)
  • Chat Input Preservation: Fixed an issue where clicking chat buttons would clear your typed message (thanks hassoncs!) (#6222)
  • Image Queueing: Fixed image queueing functionality that was not working properly (#6414)
  • Claude Code Output Tokens: Fixed truncated responses by increasing default max output tokens from 8k to 16k (thanks bpeterson1991!) (#6312)
  • Execute Command Kill Button: Fixed the kill button functionality for the execute_command tool (#6457)
  • Token Counting: Fixed accuracy issues by extracting text from messages using VSCode LM API (thanks NaccOll!) (#6424)

Provider Updates​

  • Claude Opus 4.1 Support: Added support for the new Claude Opus 4.1 model across Anthropic, Claude Code, Bedrock, Vertex AI, and LiteLLM providers with 8192 max tokens, reasoning budget support, and prompt caching
  • Z AI Provider: Z AI (formerly Zhipu AI) is now available with GLM-4.5 series models, offering dual regional support for both international and mainland China users
  • Fireworks AI Provider: New provider offering hosted versions of popular open-source models like Kimi and Qwen
  • Groq GPT-OSS Models: Added GPT-OSS-120b and GPT-OSS-20b models with 131K context windows and support for tool use, browser search, code execution, and JSON object mode
  • Cerebras GPT-OSS-120b: Added OpenAI's GPT-OSS-120b model - free to use with 64K context and ~2800 tokens/sec
  • Cerebras Provider: Added support for Cerebras as a new AI provider with Qwen 3 Coder models, offering both free and paid tier options with automatic thinking token filtering
  • Prompt Caching for LiteLLM: Reduce API costs and improve response times with caching support for Claude 3.5 Sonnet and compatible models (thanks MuriloFP, steve-gore-snapdocs!) (#6074)
  • Chutes AI - GLM-4.5-Air Model: Added support for the GLM-4.5-Air model to the Chutes AI provider with 151K token context window for complex reasoning tasks and large codebase analysis - completely free to use (thanks matbgn!) (#6377)
  • Doubao Provider: Added support for ByteDance's AI model provider with full integration including API handling (thanks AntiMoron!) (#6345)
  • SambaNova Provider: Integrated SambaNova as a new LLM provider offering high-speed inference and broader model selection (thanks snova-jorgep!) (#6188)
  • Chutes AI: Added zai-org/GLM-4.5-FP8 model support (#6441)
  • OpenRouter: Set horizon-alpha model max tokens to 32k (#6470)
  • Horizon Beta Stealth Model via OpenRouter: Optimized support for OpenRouter's new stealth model Horizon Beta with 32k max tokens for better response times. Thanks to OpenRouter for providing this free, improved version of Horizon Alpha!
  • Type Definitions: Updated @roo-code/types to v1.41.0 for latest type compatibility
  • Databricks: Added support for /invocations endpoints pattern (thanks adambrand!) (#6317)

Misc. Improvements​

  • Slash Command Interpolation: Skip interpolation for non-existent commands
  • Linter Coverage: Applied to locale README files
  • Cloud Service Events: Migrated from callbacks to event-based architecture
  • Website Updates: Phase 1 improvements
  • Background Editing (Experimental): Work uninterrupted while Roo edits files in the background—no more losing focus from automatic diff views (#6214). Files change silently while you keep coding, with diagnostics and error checking still active. See Background Editing for details.
  • Security Update: Updated form-data dependency to address security vulnerability (#6332)
  • Contributor Updates: Refreshed contributor acknowledgments across all localizations (#6302)
  • Release Engineering: Converted release engineer role to slash command for easier releases (#6333)
  • PR Reviewer Improvements: Made PR reviewer mode generic for any GitHub repository (#6357, #6328, #6324)
  • Organization MCP Controls: Added support for managing MCP servers at the organization level, allowing centralized configuration across teams (#6378)
  • Extension Title Update: Removed "(prev Roo Cline)" from the extension title across all languages (#6426)
  • Translation Improvements: Updated auto-translate prompt and added translation check action (#6430, #6393)
  • Mode Configuration: Updated PR reviewer rules and mode configuration (#6391, #6428)
  • Navigator Global Error: Resolved errors by updating mammoth and bluebird dependencies (#6363)
  • Nightly Build Fixes: Resolved marketplace freezing issues with separate changelog (#6449)
  • Cloud Provider Profile Sync: Added support for syncing provider profiles from the cloud, enabling automatic synchronization across devices and team collaboration