Roo Commander transforms your Roo Code experience by implementing a sophisticated framework for managing software development projects using a structured, multi-agent approach. Imagine having a virtual, specialized software team within your VS Code workspace, orchestrated by the 👑 Roo Commander, to handle tasks with specific expertise and maintain a clear project history.
🐾 Join the Community: Roo Commander Discord
Roo Commander isn't just a collection of modes; it's an opinionated workflow and project management system built on top of Roo Code. It addresses the challenges of complex projects and context limitations in LLMs by:
- Specialized Roles: Assigning tasks to AI agents (modes) with specific expertise (e.g., React, API Design, Git, AWS, Testing).
- Structured Communication: Using a defined task delegation and reporting system.
- Persistent Context: Leveraging a structured project journal (
.ruru/tasks/,.ruru/decisions/, etc.) and standardized document formats (TOML+Markdown) to maintain state and history effectively. - Standardized Processes: Defining reusable workflows and procedures for common development activities.
The goal is to bring structure, consistency, traceability, and the power of specialized AI skills to your development process.
- 🧠 Specialized Expertise: Delegate tasks to the right AI expert (e.g., let the
framework-reactmode handle React code, not a generalist). - 🏗️ Structured Workflow: Breaks down complex goals into manageable, trackable tasks using a defined system (MDTM).
- 💾 Enhanced Context Management: Mitigates LLM context window limitations through structured logging and dedicated context retrieval agents.
- 🔍 Traceability & Auditability: Creates a clear history of tasks, decisions (ADRs), and actions within your project repository.
- ⚙️ Consistency: Promotes consistent project structure, documentation formats, and development processes.
- 🚀 Potential for Automation: The structured nature enables more reliable automation of complex development sequences.
Understanding these concepts is key to using Roo Commander effectively:
-
Multi-Agent System (The "Team"):
- Hierarchy: Modes are organized loosely into roles: Commander (Coordination), Managers (Planning), Leads (Domain Oversight), Agents (Support), and Specialists (Execution).
- Delegation: Commander analyzes user goals and delegates tasks to the most appropriate Manager, Lead, or Specialist mode using the
new_tasktool. - (See
.ruru/modes/roo-commander/kb/kb-available-modes-summary.mdfor a list of roles in your current build).
-
Structured Project Artifacts (TOML+Markdown):
- Standard Folders: Uses hidden folders like
.ruru/tasks,.ruru/decisions,.ruru/docs,.ruru/context,.ruru/workflows,.ruru/processesfor specific artifact types. (See.roo/rules/02-workspace-default-folders.md). - TOML+MD Format: Combines machine-readable TOML metadata (for status, IDs, tags, etc.) with human-readable Markdown content in files like tasks and ADRs. Ensures consistency and facilitates automation. (See
.roo/rules/01-standard-toml-md-format.md).
- Standard Folders: Uses hidden folders like
-
Knowledge Bases (KB) & Rules:
- Rules (
.roo/rules-/): Define core operational logic, standard procedures, and triggers for each mode. Loaded into the AI's context. - Knowledge Base (
.ruru/modes/<slug>/kb/): Contains detailed reference information, complex procedures, templates, and examples specific to a mode. Looked up on demand based on rules. This balances context size with detailed knowledge access.
- Rules (
- 👑 Central Coordinator: Roo Commander orchestrates workflows and delegates tasks.
- 🚦 Project Onboarding: Streamlined process for initializing new projects or analyzing existing ones.
- 📋 Task Management (MDTM): Structured task tracking using TOML+Markdown files in
.ruru/tasks/. - 📖 Context Management: Dedicated agents (
agent-context-resolver,agent-context-condenser) help manage and summarize project information. - 🛠️ Specialist Modes: A wide range of modes covering various frameworks (React, Vue, Angular, Next.js, Laravel, Django, FastAPI, etc.), cloud platforms (AWS, Azure, GCP), databases (SQL, NoSQL), design tools (Tailwind, MUI, Bootstrap), testing, DevOps, security, and utilities.
- 📝 Decision Logging (ADRs): Formal process for recording significant architectural decisions in
.ruru/decisions/. - 🧩 Standardized Workflows & Processes: Reusable definitions in
.ruru/workflows/and.ruru/processes/.
Prerequisite: You need the Roo Code VS Code extension installed.
The recommended installation method uses the pre-built release:
- Download: Go to the [GitHub Project Builds] [link-to-latest-releases] directory and download the latest
roo-commander-vX.Y.Z-Codename.zipfile. (Currently:roo-commander-v7.1.1-Wallaby.zip) - Extract: Unzip the contents directly into the root directory of your VS Code project workspace. This is the top-level folder containing your code,
.gitdirectory (if applicable), etc. - Reload VS Code: Reload the VS Code window (
Ctrl+Shift+PorCmd+Shift+P-> "Developer: Reload Window") to ensure Roo Code recognizes the new mode configurations.
This will add/overwrite the necessary hidden configuration folders (.ruru/modes, .roo, .ruru/templates, etc.) and files (.roomodes).
- Activate Commander: Select the "👑 Roo Commander" mode in the Roo Code chat interface.
- State Your Goal: Tell Commander what you want to achieve (e.g., "Start planning a new Python API using FastAPI", "Implement the login UI based on the design in .docs/designs/login.md", "Fix the bug described in task BUG-123").
- Interact: Follow Commander's lead. It will likely:
- Ask clarifying questions.
- Propose a plan or workflow.
- Delegate tasks to specialist modes (using
<new_task>). - Ask for your approval or feedback on steps or results.
- Review: Check the files created/modified by the modes, especially in the
.ruru/tasks/directory, to understand the progress and details.
(Optional: Add guidelines if you welcome contributions)
This project is licensed under the MIT License - see the LICENSE file for details.
Command your virtual team and build amazing things!