Skip to content

docs: add search performance troubleshooting for excessive rg processes#9994

Closed
1chooo wants to merge 1 commit into
microsoft:mainfrom
1chooo:docs/search-ripgrep-troubleshooting
Closed

docs: add search performance troubleshooting for excessive rg processes#9994
1chooo wants to merge 1 commit into
microsoft:mainfrom
1chooo:docs/search-ripgrep-troubleshooting

Conversation

@1chooo

@1chooo 1chooo commented Jun 28, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new ### Search performance subsection to the ## Search across files section in docs/editing/codebasics.md, covering the four troubleshooting steps from issue Add troubleshooting steps for the spawning of excessive rg processes #9950
  • Explains that disabling the Use Exclude Settings and Ignore Files toggle causes rg to run with --no-ignore, scanning node_modules and other large directories
  • Adds an explicit search.exclude JSON example and a search.followSymlinks tip for worktree/symlink-heavy workspaces
  • Adds a Common question entry that links to the new section for FAQ discoverability

Closes #9950

Test plan

  • Verify the new ### Search performance section renders correctly on the docs site
  • Confirm all setting(...) macros resolve properly
  • Check the #search-performance anchor link in the Common questions entry works

Made with Cursor

Add a 'Search performance' subsection to the 'Search across files' section
in codebasics.md explaining that excessive background `rg` processes are
caused by the 'Use Exclude Settings and Ignore Files' toggle being disabled.
Includes four remediation steps: checking the toggle, verifying
search.useIgnoreFiles, adding explicit search.exclude patterns, and
disabling search.followSymlinks for worktree/symlink-heavy workspaces.

Also adds a Common question entry linking to the new section.

Closes microsoft#9950

Co-authored-by: Cursor <cursoragent@cursor.com>
@ntrogh

ntrogh commented Jun 28, 2026

Copy link
Copy Markdown
Collaborator

Issue is already assigned.

@ntrogh ntrogh closed this Jun 28, 2026
@1chooo

1chooo commented Jun 28, 2026

Copy link
Copy Markdown
Contributor Author

Thanks for reviewing!!!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add troubleshooting steps for the spawning of excessive rg processes

2 participants