claude-code - 💡(How to fix) Fix @ fuzzy finder does not show dotfolder contents (.agents/, .claude/, etc.) [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#44997Fetched 2026-04-09 08:15:48
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
0
Author
Timeline (top)
labeled ×4commented ×1

The @ file reference fuzzy finder fails to display contents of directories that start with a dot (e.g., .agents/, .claude/, .github/).

Root Cause

The @ file reference fuzzy finder fails to display contents of directories that start with a dot (e.g., .agents/, .claude/, .github/).

Fix Action

Workaround

Typing a filename fragment directly (e.g., @SUMMARY) can find files inside dotfolders, but folder-browsing navigation does not work.

RAW_BUFFERClick to expand / collapse

Description

The @ file reference fuzzy finder fails to display contents of directories that start with a dot (e.g., .agents/, .claude/, .github/).

Steps to Reproduce

  1. Have a project with a dotfolder structure like .agents/SYSTEM/SUMMARY.md
  2. In the Claude Code prompt, type @.agents/
  3. Observe that subfolders (e.g., SYSTEM/) do not appear in the autocomplete dropdown
  4. Regular (non-dot) folders work fine with the same interaction

Expected Behavior

Typing @.agents/ should show the folder's contents (subfolders and files) in the fuzzy finder, the same way non-dot folders do.

Actual Behavior

Dotfolder contents are missing or not surfaced in the fuzzy finder results. The fuzzy finder appears to skip or deprioritize paths under dotfolders.

Workaround

Typing a filename fragment directly (e.g., @SUMMARY) can find files inside dotfolders, but folder-browsing navigation does not work.

Environment

  • Claude Code v2.1.94
  • Windows 10 Pro 10.0.19045
  • Shell: bash

Notes

Dotfolders are common in Claude Code projects (.claude/commands/, .agents/ framework directories). The /powerup tip for @ references doesn't mention this limitation.

extent analysis

TL;DR

The issue can be mitigated by typing a filename fragment directly to find files inside dotfolders, although this does not fully resolve the folder-browsing navigation issue.

Guidance

  • The fuzzy finder's failure to display dotfolder contents suggests a potential issue with how the @ file reference handles hidden directories.
  • To verify the issue, try creating a non-dot folder with the same structure as the dotfolder and see if the fuzzy finder works as expected.
  • As a temporary workaround, users can type a filename fragment directly (e.g., @SUMMARY) to find files inside dotfolders, although this does not address the folder navigation problem.
  • The fact that regular (non-dot) folders work fine implies that the issue is specific to how the fuzzy finder handles dotfolders, and a fix may involve modifying the fuzzy finder's logic to include these directories.

Example

No specific code snippet is provided, as the issue does not imply a specific code-based solution.

Notes

The provided workaround has limitations, as it does not enable folder-browsing navigation. A full solution would require addressing the underlying issue with how the fuzzy finder handles dotfolders.

Recommendation

Apply workaround: The current workaround of typing a filename fragment directly can help users find files inside dotfolders, although it is not a complete solution. A more comprehensive fix would be needed to fully address the issue with folder navigation.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING