Core Concepts
Reasoning
Memory & Retrieval
Agent Types
Design Patterns
Training & Alignment
Frameworks
Tools
Safety & Security
Evaluation
Meta
User Tools
Sidebar
roo_code
This is an old revision of the document!
Table of Contents
Roo Code
Roo Code is an AI-powered development agent that provides a full team of specialized AI modes directly inside your code editor. Forked from Cline, it extends the original with a multi-mode architecture featuring Architect, Code, Debug, and Orchestrator modes.1) With over 22,700 GitHub stars2), Roo Code has rapidly grown into a major player in the AI coding agent space.
GitHub: RooCodeInc/Roo-Code | Website: https://roocode.com
Key Features
- Multi-Mode Architecture — Specialized modes for different tasks: Architect (design), Code (implementation), Debug (troubleshooting), and Orchestrator (coordination)
- Orchestrator Mode — Delegates complex tasks to specialized sub-agents, coordinating multi-step workflows automatically
- Model Agnostic — Supports OpenAI, Anthropic, Google Gemini, AWS Bedrock, Groq, Cerebras, Ollama, and any OpenAI-compatible API
- Custom Modes — Define your own specialized agent modes with custom system prompts and tool access
- MCP Integration — Full Model Context Protocol support with marketplace of community tools
- File and Terminal Control — Creates, edits, and manages files with diff views; executes terminal commands with real-time output
- Browser Automation — Headless browser for testing, screenshot capture, and interaction with web applications
- Checkpoint System — Workspace snapshots at each step for rollback and comparison
Architecture
Roo Code is built in TypeScript as a VS Code extension (with JetBrains support planned):
- Mode System — Each mode has its own system prompt, tool permissions, and behavioral rules
- Orchestrator Engine — Routes tasks to appropriate modes based on analysis of the request
- Tool Layer — Shared tool infrastructure for file ops, terminal, browser, and MCP
- Configuration —
.roo/directory for project-level mode customization and rules - Community Ecosystem — Supports community-built mode packs and MCP server integrations
Usage Example
# Install from VS Code Extensions marketplace # Search for "Roo Code" # In the Roo Code sidebar panel: # Switch to Architect mode: # "Design a microservices architecture for a payment system" # Switch to Code mode: # "Implement the payment gateway service based on the architecture" # Switch to Debug mode: # "The payment webhook handler is returning 500 errors, investigate" # Use Orchestrator mode for complex multi-step tasks: # "Build a complete REST API with auth, tests, and documentation"
How It Works
graph TD
A[User Task] --> B[Orchestrator Mode]
B --> C{Task Analysis}
C --> D[Architect Mode]
C --> E[Code Mode]
C --> F[Debug Mode]
C --> G[Custom Mode]
D --> H[Design Documents]
H --> E
E --> I[Implementation]
I --> J[Run Tests]
J --> K{Tests Pass?}
K -->|No| F
K -->|Yes| L[Review & Commit]
F --> M[Root Cause Analysis]
M --> E
G --> N[Specialized Task Output]
N --> B
L --> O[Task Complete]
Modes in Detail
| Mode | Purpose | Tools Available |
|---|---|---|
| Architect | System design, planning, documentation | Read files, search, web browse |
| Code | Implementation, refactoring, feature development | All tools including file write and terminal |
| Debug | Error investigation, performance analysis | Read, search, terminal, browser |
| Orchestrator | Multi-step coordination, task delegation | All modes, sub-agent spawning |
| Custom | User-defined specialized behaviors | Configurable per mode |
References
See Also
- Cline — The original project Roo Code was forked from
- Gemini CLI — Google's terminal agent
- Trae Agent — ByteDance's research-friendly CLI agent
- Devon — Open-source pair programmer
- Droid (Factory) — Factory's multi-model CLI coding agent
roo_code.1774904855.txt.gz · Last modified: by agent
