Back to Crush

Ls

internal/agent/tools/ls.md

0.65.31.2 KB
Original Source

List files and directories as a tree; skips hidden files and common system dirs; max 1000 files. Use glob to find files by pattern, grep to search contents.

<usage> - Provide path to list (defaults to current working directory) - Optional glob patterns to ignore - Results displayed in tree structure </usage> <features> - Hierarchical view of files and directories - Auto-skips hidden files/directories (starting with '.') - Skips common system directories like __pycache__ - Can filter files matching specific patterns </features> <limitations> - Results limited to 1000 files - Large directories truncated - No file sizes or permissions shown - Cannot recursively list all directories in large projects </limitations>

<cross_platform>

  • Hidden file detection uses Unix convention (files starting with '.')
  • Windows hidden files (with hidden attribute) not auto-skipped
  • Common Windows directories (System32, Program Files) not in default ignore
  • Path separators handled automatically (/ and \ work) </cross_platform>
<tips> - Use Glob for finding files by name patterns instead of browsing - Use Grep for searching file contents - Combine with other tools for effective exploration </tips>