feat: add Concurrent File Reads feature and Marketplace documentation

Author: hannesrudolph

docs/features/concurrent-file-reads.md

@@ -0,0 +1,58 @@
+# Concurrent File Reads
+
+The Concurrent File Reads feature allows Roo to read multiple files from your workspace in a single step. This significantly improves efficiency when working on tasks that require context from several files, as Roo can gather all the necessary information at once instead of reading files one by one.
+
+### Key Features
+- Read up to 100 files in a single request.
+- Enabled by default for a faster, more streamlined workflow.
+- Configurable to allow disabling the feature or changing the concurrency limit.
+
+## Benefits
+
+-   **Increased Speed**: Reduces the time it takes for Roo to understand your code by minimizing the number of back-and-forth steps.
+-   **Better Context**: Allows Roo to build a more complete mental model of your code, leading to more accurate and relevant responses.
+-   **Improved Workflow**: Streamlines tasks that require information from multiple files, making you more productive.
+
+---
+
+## Why This Matters
+
+**Faster Context Building**: Previously, when Roo needed to understand your project, you'd see multiple requests like:
+- "Can I read `src/app.js`?" → You approve
+- "Now can I read `src/utils.js`?" → You approve
+- "And can I read `src/config.json`?" → You approve
+
+**With concurrent file reads**: Roo asks once to read all related files together, getting the full picture immediately and providing better assistance faster.
+
+## How it Works
+
+When you ask Roo to perform a task that involves multiple files, it will automatically identify the relevant files and read them together. This is especially useful for:
+
+-   Understanding the overall structure of a component that is split across multiple files.
+-   Refactoring code that has dependencies in other parts of the codebase.
+-   Answering questions that require a broad understanding of your project.
+
+Roo is instructed to use this feature efficiently by prioritizing the most critical files and reading them in a single batch. The [`read_file`](/advanced-usage/available-tools/read-file) tool automatically accepts multiple files in a single request.
+
+When Roo requests to read multiple files, you'll see a batch approval interface that displays:
+
+- List of all files to be read
+- File paths with line range indicators (if specified)
+- Clickable file headers to open files in your editor
+- **Approve All** and **Deny All** buttons for quick decisions
+
+---
+
+## Configuration
+
+You can configure the Multi-File Read feature by clicking the <Codicon name="gear" /> icon and navigating to the "Context" section of the settings.
+
+<img src="/img/concurrent-file-reads/concurrent-file-reads.png" alt="Concurrent file reads settings" width="600" />
+
+1.  **Enable/Disable Concurrent File Reads**:
+    *   **Setting**: `Enable concurrent file reads`
+    *   **Description**: This toggle switch controls whether Roo can read multiple files at once. It is enabled by default. You might want to disable this if you are using a less capable model or if you prefer to have more granular control over which files Roo is accessing.
+
+2.  **Concurrent File Reads Limit**:
+    *   **Setting**: `Concurrent file reads limit`
+    *   **Description**: This setting determines the maximum number of files that Roo can read in a single request. The default is 15, but it can be set to a maximum of 100. Higher values can speed up tasks involving many small files but may use more memory.

docs/features/experimental/concurrent-file-reads.md

@@ -17,8 +17,8 @@ To enable or disable experimental features:
 The following experimental features are currently available:
 
 - [Codebase Indexing](/features/experimental/codebase-indexing) - Semantic search through AI-powered codebase indexing
-- [Concurrent File Reads](/features/experimental/concurrent-file-reads) - Read multiple files simultaneously for improved efficiency
 - [Power Steering](/features/experimental/power-steering)
+- [Marketplace](/features/marketplace) - Discover and install modes and MCP servers to extend Roo Code
 
 ## Providing Feedback
 

docs/features/experimental/experimental-features.md

@@ -0,0 +1,110 @@
+---
+title: Marketplace
+description: Discover and install modes and MCPs to extend Roo Code's capabilities
+---
+import Codicon from '@site/src/components/Codicon';
+
+# Roo Code Marketplace
+
+## Overview
+
+The Roo Code Marketplace is a central hub for discovering and installing community-contributed extensions, known as Modes and MCPs (Model Context Protocol). It allows you to easily extend the functionality of Roo Code to fit your specific needs and workflows.
+
+### Key Features
+- **Discoverability**: Browse a curated list of Modes and MCPs.
+- **Simple Installation**: Install and remove items with a single click.
+- **Community-Driven**: Access a growing collection of extensions from the Roo Code community.
+- **Project & Global Scopes**: Install items for a specific project or for all your projects.
+
+### Target Audiences
+- **End Users**: Anyone using Roo Code who wants to customize their experience with new Modes or connect to new AI models and tools via MCPs.
+- **Developers**: Developers who want to share their own Modes and MCPs with the community.
+
+---
+
+## Getting Started
+
+The Roo Code Marketplace is available directly within the Roo Code extension in VS Code. You can access it from the Roo Code sidebar.
+
+:::warning Experimental Feature
+The Marketplace is an experimental feature and must be enabled in settings.
+
+1.  Open Roo Code settings (<Codicon name="gear" />).
+2.  Navigate to **Roo Code > Experimental Settings**.
+3.  Enable the **Marketplace** option.
+
+See the main [Experimental Features](/features/experimental/experimental-features) page for more information.
+:::
+
+---
+
+## Marketplace Items
+
+The marketplace offers two types of items:
+
+### Modes
+Modes are custom sets of instructions and rules that tailor Roo Code's behavior for specific tasks. For example, you might find a "React Component" mode that is optimized for creating React components, or a "Documentation Writer" mode for writing technical documentation.
+
+### MCPs (Model Context Protocol)
+MCPs allow Roo Code to connect to and interact with various AI models, APIs, and other external tools. By installing an MCP, you can configure Roo Code to use different language models (like those from OpenAI, Anthropic, or others) or to integrate with other services.
+
+---
+
+## Installation Scope
+
+When you install an item from the marketplace, you can choose to install it at the project level or the global level.
+
+### Project Installation
+- **Scope**: The item is only available within the current VS Code workspace (your project).
+- **Configuration File**:
+    - **Modes**: `.roomodes` in the root of your project.
+    - **MCPs**: `.roo/mcp.json` in the root of your project.
+- **Use Case**: This is useful when an item is specific to a particular project's needs or when you want to share a project-specific configuration with your team.
+
+### Global Installation
+- **Scope**: The item is available across all your VS Code workspaces.
+- **Configuration File**:
+    - **Modes**: `custom-modes.yaml` in the Roo Code extension's global settings directory.
+    - **MCPs**: `mcp-settings.json` in the Roo Code extension's global settings directory.
+- **Use Case**: This is ideal for items that you want to use in all your projects, such as a favorite Mode or a commonly used MCP.
+
+---
+
+## Using the Marketplace
+
+### Browsing and Filtering
+You can browse all available items in the marketplace view. To find specific items, you can:
+- **Search**: Use the search bar to find items by name or description.
+- **Filter by Type**: Filter to show only Modes or only MCPs.
+- **Filter by Tags**: Filter by tags to find items related to specific technologies or tasks.
+
+### Installing an Item
+1. Find the item you want to install.
+2. Click the "Install" button.
+3. If prompted, choose whether to install it for the current **Project** or **Globally**.
+4. For some MCPs, you may be asked to provide additional parameters (see [Parameterized MCPs](#parameterized-mcps)).
+5. Roo Code will automatically add the item to the appropriate configuration file and notify you upon successful installation. The configuration file will be opened for your review.
+
+### Removing an Item
+1. Find the installed item in the marketplace view.
+2. Click the "Uninstall" button.
+3. Roo Code will remove the item from the corresponding configuration file.
+
+### Parameterized MCPs
+Some MCPs require you to provide specific information during installation, such as an API key or a URL. These are called "parameterized" MCPs.
+
+When you install a parameterized MCP, you will be prompted to enter the required values. This allows for a more flexible and secure way to configure MCPs without hardcoding sensitive information.
+
+---
+
+## Troubleshooting
+
+### Installation Errors
+- **Invalid YAML/JSON**: If you see an error about invalid YAML or JSON, it means the configuration file (`.roomodes`, `.roo/mcp.json`, etc.) has a syntax error. You will need to fix the error in the file before you can install or remove items.
+- **File Not Found**: This error should not typically occur, as Roo Code will create the necessary configuration files if they don't exist.
+
+### Item Not Working
+If you've installed an item but it doesn't seem to be working:
+- **Check the configuration file**: Ensure the item was added correctly.
+- **Restart VS Code**: Sometimes a restart is necessary to load new configurations.
+- **Check for prerequisites**: Some items may have prerequisites listed in their description.

docs/features/marketplace.mdx

@@ -118,6 +118,10 @@ const config: Config = {
             to: '/features/experimental/experimental-features',
             from: ['/advanced-usage/experimental-features'],
           },
+          {
+            to: '/features/concurrent-file-reads',
+            from: ['/features/experimental/concurrent-file-reads'],
+          },
           {
             to: '/features/model-temperature',
             from: ['/advanced-usage/model-temperature'],

docusaurus.config.ts

@@ -35,6 +35,7 @@ const sidebars: SidebarsConfig = {
         'features/intelligent-context-condensing',
         'features/keyboard-shortcuts',
         'features/model-temperature',
+        'features/concurrent-file-reads',
         'features/rooignore',
         'features/settings-management',
         'features/shell-integration',
@@ -61,8 +62,8 @@ const sidebars: SidebarsConfig = {
           items: [
             'features/experimental/experimental-features',
             'features/experimental/codebase-indexing',
-            'features/experimental/concurrent-file-reads',
             'features/experimental/power-steering',
+            'features/marketplace',
           ],
         },
         'features/more-features',