====== Roo Code ======

**Roo Code** is an AI-powered development agent that provides a full team of specialized AI modes directly inside your code editor.(([[https://roocode.com|Official Website]]))((https://github.com/RooCodeInc/Roo-Code)) Forked from [[cline|Cline]], it extends the original with a multi-mode architecture featuring Architect, Code, Debug, and Orchestrator modes. With over **22,700 GitHub stars**, Roo Code has rapidly grown into a major player in the AI coding agent space.

GitHub: [[https://github.com/RooCodeInc/Roo-Code|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):((https://docs.roocode.com))

  * **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 =====

<code bash>
# 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"
</code>

===== How It Works =====

<mermaid>
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]
</mermaid>

===== 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 |

===== See Also =====

  * [[cline|Cline]] — The original project Roo Code was forked from
  * [[gemini_cli|Gemini CLI]] — Google's terminal agent
  * [[trae_agent|Trae Agent]] — ByteDance's research-friendly CLI agent
  * [[devon|Devon]] — Open-source pair programmer
  * [[droid_factory|Droid (Factory)]] — Factory's multi-model CLI coding agent

===== References =====