1List directory contents in tree structure. Use this instead of shell `ls`.
 2
 3<when_to_use>
 4Use LS when:
 5- Exploring project structure
 6- Finding what's in a directory
 7- Understanding folder organization
 8- Checking if files/directories exist
 9
10Do NOT use LS when:
11- Finding files by pattern → use `glob`
12- Searching file contents → use `grep`
13- Reading file contents → use `view`
14</when_to_use>
15
16<parameters>
17- path: Directory to list (default: current directory)
18- ignore: Glob patterns to exclude (optional)
19- depth: Max traversal depth (optional)
20</parameters>
21
22<output>
23- Hierarchical tree structure
24- Skips hidden files (starting with '.')
25- Skips common system dirs (__pycache__, node_modules, etc.)
26- Limited to 1000 files
27</output>
28
29<examples>
30List project root:
31```
32path: "."
33```
34
35List src excluding tests:
36```
37path: "src"
38ignore: ["*_test.go", "*.test.ts"]
39```
40</examples>
41
42<tip>
43For large projects, use `glob` to find specific files instead of browsing the entire tree.
44</tip>