Skip to content

Update custom-modes.md with .roomodes #107

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mrubens merged 1 commit into from
Mar 31, 2025
Merged

Update custom-modes.md with .roomodes #107

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/features/custom-modes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ Note: If both `.clinerules-{mode-slug}` and the `customInstructions` property ex
Mode configurations are applied in this order:

1. Project-level mode configurations (from `.roomodes`)
2. Global mode configurations (from `cline_custom_modes.json`)
2. Global mode configurations (from `custom_modes.json`)
3. Default mode configurations

This means that project-specific configurations will override global configurations, which in turn override default configurations.
Expand Down Expand Up @@ -152,7 +152,7 @@ You can find this setting within the prompt settings by clicking the <Codicon na

* **Name:** Enter a display name for the mode
* **Slug:** Enter a lowercase identifier (letters, numbers, and hyphens only)
* **Save Location:** Choose Global (via `cline_custom_modes.json`, available across all workspaces) or Project-specific (via `.roomodes` file in project root)
* **Save Location:** Choose Global (via `custom_modes.json`, available across all workspaces) or Project-specific (via `.roomodes` file in project root)
* **Role Definition:** Define Roo's expertise and personality for this mode (appears at the start of the system prompt)
* **Available Tools:** Select which tools this mode can use
* **Custom Instructions:** (Optional) Add behavioral guidelines specific to this mode (appears at the end of the system prompt)
Expand All @@ -169,7 +169,7 @@ Both global and project-specific configurations can be edited through the Prompt
1. **Open Prompts Tab:** Click the <Codicon name="notebook" /> icon in the Roo Code top menu bar
2. **Access Settings Menu:** Click the <Codicon name="bracket" /> button to the right of the Modes heading
3. **Choose Configuration:**
* Select "Edit Global Modes" to edit `cline_custom_modes.json` (available across all workspaces)
* Select "Edit Global Modes" to edit `custom_modes.json` (available across all workspaces)
* Select "Edit Project Modes" to edit `.roomodes` file (in project root)
4. **Edit Configuration:** Modify the JSON file that opens
5. **Save Changes:** Roo Code will automatically detect the changes
Expand Down Expand Up @@ -282,4 +282,4 @@ Roo will generate the appropriate pattern with proper escaping for JSON configur
:::

## Community Gallery
Ready to explore more? Check out the [Custom Modes Gallery](/community#custom-modes-gallery) to discover and share custom modes created by the community!
Ready to explore more? Check out the [Custom Modes Gallery](/community#custom-modes-gallery) to discover and share custom modes created by the community!