1Directory listing tool that shows files and subdirectories in a tree structure, helping you explore and understand the project organization.
 2
 3WHEN TO USE THIS TOOL:
 4
 5- Use when you need to explore the structure of a directory
 6- Helpful for understanding the organization of a project
 7- Good first step when getting familiar with a new codebase
 8
 9HOW TO USE:
10
11- Provide a path to list (defaults to current working directory)
12- Optionally specify glob patterns to ignore
13- Results are displayed in a tree structure
14
15FEATURES:
16
17- Displays a hierarchical view of files and directories
18- Automatically skips hidden files/directories (starting with '.')
19- Skips common system directories like **pycache**
20- Can filter out files matching specific patterns
21
22LIMITATIONS:
23
24- Results are limited to 1000 files
25- Very large directories will be truncated
26- Does not show file sizes or permissions
27- Cannot recursively list all directories in a large project
28
29WINDOWS NOTES:
30
31- Hidden file detection uses Unix convention (files starting with '.')
32- Windows-specific hidden files (with hidden attribute) are not automatically skipped
33- Common Windows directories like System32, Program Files are not in default ignore list
34- Path separators are handled automatically (both / and \ work)
35
36TIPS:
37
38- Use Glob tool for finding files by name patterns instead of browsing
39- Use Grep tool for searching file contents
40- Combine with other tools for more effective exploration