feat: add support for AGENTS.local.md personal override files by roomote-v0[bot] · Pull Request #11183 · RooCodeInc/Roo-Code

roomote-v0 · 2026-02-04T00:28:35Z

Related GitHub Issue

This PR was initiated from a Roo Code Cloud task request.

Roo Code Task Context (Optional)

Description

This PR adds support for AGENTS.local.md files alongside AGENTS.md files, providing users with a place to put personal overrides or preferences that they might not want to check in to version control.

Key implementation details:

Modified loadAgentRulesFileFromDirectory in src/core/prompts/sections/custom-instructions.ts to also look for .local.md variants after loading the base file
When AGENTS.md exists, the system now also checks for AGENTS.local.md and appends its content (same for AGENT.md/AGENT.local.md)
Added .gitignore patterns to exclude AGENTS.local.md and AGENT.local.md from version control
Local files are only loaded if a base file exists (standalone local files without a base are ignored)

The local file content is displayed with a distinct header (# Agent Rules Local (AGENTS.local.md):) to differentiate it from the standard rules.

Test Procedure

Ran unit tests: cd src && npx vitest run core/prompts/sections/__tests__/custom-instructions.spec.ts - all 42 tests pass
Added 4 new tests specifically for AGENTS.local.md functionality:
- Loading AGENTS.local.md alongside AGENTS.md
- Loading AGENT.local.md alongside AGENT.md
- Not loading local file when base file does not exist
- Loading AGENTS.md without local file when local does not exist
ESLint passes with no warnings

Pre-Submission Checklist

Issue Linked: This PR is linked to a Roo Code Cloud task
Scope: Changes are focused on adding AGENTS.local.md support
Self-Review: I have performed a thorough self-review of my code
Testing: New unit tests have been added to cover the changes
Documentation Impact: Documentation updates may be needed to describe the new feature
Contribution Guidelines: I have read and agree to the Contributor Guidelines

Screenshots / Videos

N/A - No UI changes

Documentation Updates

No documentation updates are required.
Yes, documentation updates may be required to describe how users can use AGENTS.local.md for personal overrides.

Additional Notes

This feature provides a convenient way for developers to maintain personal agent rule overrides without affecting the shared AGENTS.md that is checked into version control. The .local.md files are automatically gitignored.

Important

Adds support for AGENTS.local.md files for personal agent rule overrides, with tests and .gitignore updates.

Behavior:
- loadAgentRulesFileFromDirectory in custom-instructions.ts now loads AGENTS.local.md after AGENTS.md.
- Appends AGENTS.local.md content if it exists, even if AGENTS.md does not.
- .gitignore updated to exclude AGENTS.local.md and AGENT.local.md.
Tests:
- Added tests in custom-instructions.spec.ts for loading AGENTS.local.md with/without AGENTS.md.
- Tests ensure local files are ignored if no base file exists.
Misc:
- AGENTS.local.md content displayed with header # Agent Rules Local (AGENTS.local.md):.

^{This description was created by}^{for f17637d. You can customize this summary. It will automatically update as commits are pushed.}

roomote-v0 · 2026-02-04T00:29:06Z

Rooviewer See task on Roo Cloud

Review complete. No issues found.

The latest commit (fb5d347) reverts the behavior back to preferring AGENTS.md over AGENT.md when both exist. The implementation correctly:

Prefers AGENTS.md and breaks after finding it (does not also load AGENT.md)
Always loads AGENTS.local.md for personal overrides, even when no base file exists
Has comprehensive test coverage for all scenarios

All previously flagged issues have been resolved.

Previous reviews

f17637d: Review #1

2b10ff6: Review #2

2bf95ec: Review #3

65b9354: Review #4

65b9354: Review #5

6613d77: Review #6

_{Mention @roomote in a comment to request specific changes to this pull request or fix all unresolved issues.}

mrubens · 2026-02-04T00:35:30Z

src/core/prompts/sections/__tests__/custom-instructions.spec.ts

+		expect(result).toContain("Local overrides from AGENTS.local.md")
+	})
+
+	it("should not load AGENT.local.md (only AGENTS.local.md is supported)", async () => {


@roomote just remove this test, don't need to test AGENT.md

roomote-v0 · 2026-02-04T00:36:26Z

Rooviewer See task on Roo Cloud

Review complete. The implementation is clean and well-structured.

Address @mrubens feedback: remove the AGENT.md test (comment #2761638761)

_{Mention @roomote in a comment to request specific changes to this pull request or fix all unresolved issues.}

roomote-v0 · 2026-02-04T00:37:08Z

Fixaroo See task on Roo Cloud

Removed the unnecessary AGENT.md test as requested. All local checks passed.

_{View commit | Revert commit}

mrubens · 2026-02-04T01:00:19Z

src/core/prompts/sections/__tests__/custom-instructions.spec.ts

+		expect(result).toContain("Local overrides from AGENTS.local.md")
+	})
+
+	it("should not load AGENTS.local.md when base AGENTS.md does not exist", async () => {


@roomote it should load this even if AGENTS.md doesn't exist

roomote-v0 · 2026-02-04T01:01:54Z

Fixaroo See task on Roo Cloud

Fixed the reported issue. AGENTS.local.md now loads even when AGENTS.md doesn't exist. All tests pass.

_{View commit | Revert commit}

…) when present - Remove break statement to load both AGENTS.md and AGENT.md if they exist - Update function documentation to clarify all files are loaded - Update test to verify both files are loaded when both exist

…local.md) when present" This reverts commit f17637d.

feat: add support for AGENTS.local.md personal override files

6613d77

github-project-automation bot added this to Roo Code Roadmap Feb 4, 2026

github-project-automation bot moved this to New in Roo Code Roadmap Feb 4, 2026

refactor: only support AGENTS.local.md (not AGENT.local.md)

65b9354

mrubens marked this pull request as ready for review February 4, 2026 00:34

mrubens requested review from cte, jr and mrubens as code owners February 4, 2026 00:34

dosubot bot added size:L This PR changes 100-499 lines, ignoring generated files. Enhancement New feature or request labels Feb 4, 2026

mrubens reviewed Feb 4, 2026

View reviewed changes

test: remove unnecessary AGENT.md test

2bf95ec

mrubens reviewed Feb 4, 2026

View reviewed changes

roomote added 2 commits February 4, 2026 01:03

fix: load AGENTS.local.md even without base AGENTS.md file

2b10ff6

mrubens approved these changes Feb 4, 2026

View reviewed changes

dosubot bot added the lgtm This PR has been approved by a maintainer label Feb 4, 2026

RooCodeInc deleted a comment from roomote-v0 bot Feb 4, 2026

Revert "fix: load all agent rules files (AGENTS.md, AGENT.md, AGENTS.…

fb5d347

…local.md) when present" This reverts commit f17637d.

RooCodeInc deleted a comment from roomote-v0 bot Feb 4, 2026

mrubens merged commit 1da2b1c into main Feb 4, 2026
10 checks passed

mrubens deleted the feature/agents-local-md-support branch February 4, 2026 20:53

github-project-automation bot moved this from New to Done in Roo Code Roadmap Feb 4, 2026

mini2s referenced this pull request in zgsm-ai/costrict Feb 5, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add support for AGENTS.local.md personal override files#11183

feat: add support for AGENTS.local.md personal override files#11183
mrubens merged 6 commits intomainfrom
feature/agents-local-md-support

roomote-v0 bot commented Feb 4, 2026 •

edited by ellipsis-dev bot

Loading

Uh oh!

roomote-v0 bot commented Feb 4, 2026 •

edited

Loading

Uh oh!

mrubens Feb 4, 2026

Uh oh!

roomote-v0 bot commented Feb 4, 2026 •

edited

Loading

Uh oh!

roomote-v0 bot commented Feb 4, 2026 •

edited

Loading

Uh oh!

mrubens Feb 4, 2026

Uh oh!

roomote-v0 bot commented Feb 4, 2026 •

edited

Loading

Uh oh!

Uh oh!

Conversation

roomote-v0 bot commented Feb 4, 2026 • edited by ellipsis-dev bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related GitHub Issue

Roo Code Task Context (Optional)

Description

Test Procedure

Pre-Submission Checklist

Screenshots / Videos

Documentation Updates

Additional Notes

Uh oh!

roomote-v0 bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mrubens Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

roomote-v0 bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

roomote-v0 bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mrubens Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

roomote-v0 bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

roomote-v0 bot commented Feb 4, 2026 •

edited by ellipsis-dev bot

Loading

roomote-v0 bot commented Feb 4, 2026 •

edited

Loading

roomote-v0 bot commented Feb 4, 2026 •

edited

Loading

roomote-v0 bot commented Feb 4, 2026 •

edited

Loading

roomote-v0 bot commented Feb 4, 2026 •

edited

Loading