Roo Code Documentation

Roo Code Router is a managed provider service designed to simplify the use of Roo Code by removing the need to manage individual API keys for various LLM providers. It allows users to access a curated selection of tested and approved models (including frontier models from Anthropic, OpenAI, Google, xAI, and open-weight models from Moonshot AI, MiniMax, etc.) using only a Roo Code Cloud account.

Key benefits include:

• No API Key Management: Access multiple models through your Roo Code Cloud account.
• Team Access: The Team plan allows sharing access across an entire team without distributing individual provider keys.
• Curated Models: Only models verified to work effectively with Roo Code are offered.

Roo Code Cloud is a web platform companion to the Roo Code VS Code extension. It provides cloud-based extensions to the core functionality, including task syncing, sharing, and usage analytics. It also enables the use of Cloud Agents, which allow you to run Roo tasks in the cloud independently of the VS Code extension.

Key characteristics:

• Model-Agnostic: Supports various providers.
• BYO Keys: You can bring your own model API keys to maintain control over inference costs and models.
• Hybrid Pricing: Some features (Sync, Analytics, Sharing) are free, while others (Cloud Agents, Billing) are paid.

Roo Code provides several experimental capabilities that allow for extended functionality. The following features are currently available:

• Custom Tools: Define TypeScript/JavaScript tools that Roo can call similarly to built-in tools.
• Background Editing: Allows you to continue working uninterrupted while Roo performs file edits in the background.
• Image Generation: Enables generating images from text prompts and saving them directly to your workspace.
• Run Slash Command: Allows the execution of predefined slash commands for templated instructions and workflow automation.

Roo Code Cloud provides autonomous Cloud Agents that operate independently in the cloud. Unlike standard editor-based assistants, these agents can plan, code, review, and fix issues autonomously. They are accessible via GitHub PRs, Slack messages, or a web browser.

Key features that augment the Roo Code VS Code extension include:

• Roo Code Router: Access to centralized LLM routing.
• Task Sync: Unified access to your entire task history.
• Task sharing: Ability to share specific tasks with collaborators.
• Token usage analytics: Visibility into token and cost consumption.

Version 3.28.4 introduced several Quality of Life (QOL) enhancements to the user interface:

• Redesigned Message Feed: A cleaner chat interface with improved visual hierarchy for better readability.
• Responsive Auto-Approve: The auto-approve dropdown now uses smart 1-2 column layouts that adapt to window sizes, and tooltips are designed to show all enabled actions without truncation.
• Network Resilience: Telemetry data now includes automatic retries on network failures to prevent loss of diagnostics during connectivity issues.

Roo Code implements the Model Context Protocol to extend its capabilities without requiring core modifications. Specifically, Roo Code uses MCP to:

• Connect to both local and remote MCP servers.
• Provide a consistent interface for accessing external tools.
• Enable specialized capabilities on demand (e.g., interacting with specific databases or local file systems).

Roo Code is an AI-coding suite that uses frontier models with file system access, terminal control, and multi-step workflows to perform the following tasks:

• Code Generation: Create code from natural language descriptions and specifications.
• Refactoring & Debugging: Improve existing code or fix bugs.
• Documentation: Write and update project documentation.
• Codebase Intelligence: Answer questions about your existing codebase.
• Automation: Automate repetitive development tasks.
• MCP Integration: Utilize Model Context Protocol (MCP) Servers.

Roo Code leverages the Model Context Protocol (MCP) to provide a universal connector between the agent and external services. This approach provides:

1. Extensibility: Add unlimited custom tools without waiting for official integrations.
2. Contextual awareness: Tools can access conversation history and project context.
3. Simplified integration: Uses one standard protocol rather than managing numerous individual API patterns.
4. Runtime flexibility: The ability to discover and use new capabilities on-the-fly.

Version 3.23.19 introduces two significant Quality of Life (QOL) improvements to how commands are processed:

• Smarter Command Validation: The system now uses improved validation logic that only auto-denies subshell commands if they contain specific denied prefixes. This reduces false positives and allows more commands to be executed safely.
• Multi-line Command Support: Commands containing newlines are now properly parsed. This improves compatibility and ease of use for multi-line commands across Unix, Windows, and legacy Mac operating systems.

Version 3.12 includes several usability enhancements:

• Dropdown Search: Search bars have been added to the mode and profile select dropdowns for faster navigation.
• Improved Context UI: Enhanced the UI for mentioning files and folders in context.
• Cleaner Task Header: Zero cost values are now suppressed in the task header to reduce UI clutter.
• Reliability: Improved pre-diff string normalization for whitespace-sensitive languages and faster, more reliable checkpoints for project state management.