|
1 | 1 | # Custom Modes |
2 | 2 |
|
3 | | -Roo Code allows you to create **custom modes** to tailor its behavior to specific tasks or workflows. Custom modes let you define: |
| 3 | +Roo Code allows you to create **custom modes** that can be either global (available across all projects) or project-specific (defined within a single project). These modes let you tailor Roo's behavior to specific tasks or workflows by defining: |
4 | 4 |
|
5 | 5 | * **A unique name and slug:** For easy identification. |
6 | 6 | * **A role definition:** A description of the mode's purpose and expertise. |
@@ -36,21 +36,33 @@ Roo Code will guide you through the process. |
36 | 36 | 1. **Open the Prompts Tab:** Click the notebook icon in the Roo Code top menu bar. |
37 | 37 | 2. **Click "Create New Mode":** Use the "+" button to add a new mode. |
38 | 38 | 3. **Fill in the Fields:** Enter the mode's name, role definition, custom instructions, and select the allowed tool groups. |
39 | | -4. **Add File Restrictions:** For the "edit" group, you can optionally specify a regular expression to restrict file access. |
40 | | -5. **Click "Create Mode":** Save your new mode. |
| 39 | +4. **Click "Create Mode":** Save your new mode. |
| 40 | + |
| 41 | +Note: Adding/editing file type restrictions is not yet supported in the prompts tab UI. |
41 | 42 |
|
42 | 43 | ### 3. Manual Configuration (Advanced) |
43 | 44 |
|
44 | | -For advanced users, you can directly edit the `cline_custom_modes.json` file: |
| 45 | +Custom modes can be configured in two locations: |
| 46 | + |
| 47 | +1. **Global Configuration:** |
| 48 | + - Located at `~/Library/Application Support/Cursor/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_custom_modes.json` |
| 49 | + - These modes are available across all projects |
| 50 | + |
| 51 | +2. **Project-Specific Configuration:** |
| 52 | + - Located in `.roomodes` file in your project's root directory |
| 53 | + - These modes are only available within that specific project |
| 54 | + - Project-specific modes take precedence over global modes with the same slug |
| 55 | + |
| 56 | +To edit either configuration: |
45 | 57 |
|
46 | 58 | 1. **Open the Prompts Tab:** Click the notebook icon in the Roo Code top menu bar. |
47 | | -2. **Open the Settings File:** Click the code icon (`<>`) in the top right corner of the "Prompts" tab. This will open the `cline_custom_modes.json` file in a VS Code editor. |
| 59 | +2. **Open the Settings File:** Click the code icon (`<>`) in the top right corner of the "Prompts" tab. |
48 | 60 | 3. **Edit the JSON:** Add or modify mode configurations within the `customModes` array, following the format described below. |
49 | 61 | 4. **Save the File:** Roo Code will automatically detect the changes. |
50 | 62 |
|
51 | 63 | ## Custom Mode Configuration (JSON Format) |
52 | 64 |
|
53 | | -The `cline_custom_modes.json` file uses a JSON format. Here's an example: |
| 65 | +Both global and project-specific configuration files use the same JSON format. Here's an example: |
54 | 66 |
|
55 | 67 | ```json |
56 | 68 | { |
|
0 commit comments