- Find files matching glob patterns (e.g., "*.ts", "**/*.tsx", "src/**/*.{js,ts}")
- Returns file paths relative to the search directory
- Supports standard glob syntax: `*` (any chars), `**` (any dirs), `{a,b}` (alternatives), `[abc]` (character sets)
- Automatically excludes common build/cache folders (node_modules, dist, .git, etc.)
- Results sorted by modification time (most recent first)

**Use `glob` first to discover files** before reading them, unless you already know exact paths.

Think of `glob` as the repository's fast local `find` replacement for filenames and paths. Use it before shelling out to `find`, `fd`, or `ls **`.

## Usage tips

- Use `glob` for filename patterns; use `search` for file contents.
- Combine with `path` to restrict the search to a subdirectory.
- Prefer reading a known file directly over globbing to "find" it (check the `<project>` listing in the system prompt first).
- Instead of `find packages -name "*.ts"`, call `glob` with `pattern: "packages/**/*.ts"`.
- Instead of `find apps -name package.json`, call `glob` with `pattern: "apps/**/package.json"`.
