1Fast file pattern matching tool that finds files by name and pattern, returning matching paths sorted by modification time (newest first).
 2
 3WHEN TO USE THIS TOOL:
 4
 5- Use when you need to find files by name patterns or extensions
 6- Great for finding specific file types across a directory structure
 7- Useful for discovering files that match certain naming conventions
 8
 9HOW TO USE:
10
11- Provide a glob pattern to match against file paths
12- Optionally specify a starting directory (defaults to current working directory)
13- Results are sorted with most recently modified files first
14
15GLOB PATTERN SYNTAX:
16
17- '\*' matches any sequence of non-separator characters
18- '\*\*' matches any sequence of characters, including separators
19- '?' matches any single non-separator character
20- '[...]' matches any character in the brackets
21- '[!...]' matches any character not in the brackets
22
23COMMON PATTERN EXAMPLES:
24
25- '\*.js' - Find all JavaScript files in the current directory
26- '\*_/_.js' - Find all JavaScript files in any subdirectory
27- 'src/\*_/_.{ts,tsx}' - Find all TypeScript files in the src directory
28- '\*.{html,css,js}' - Find all HTML, CSS, and JS files
29
30LIMITATIONS:
31
32- Results are limited to 100 files (newest first)
33- Does not search file contents (use Grep tool for that)
34- Hidden files (starting with '.') are skipped
35
36WINDOWS NOTES:
37
38- Path separators are handled automatically (both / and \ work)
39- Uses ripgrep (rg) command if available, otherwise falls back to built-in Go implementation
40
41TIPS:
42
43- Patterns should use forward slashes (/) for cross-platform compatibility
44- For the most useful results, combine with the Grep tool: first find files with Glob, then search their contents with Grep
45- When doing iterative exploration that may require multiple rounds of searching, consider using the Agent tool instead
46- Always check if results are truncated and refine your search pattern if needed