# fs.glob

Find files matching a pattern.

## Usage

```python
fs.glob(pattern)
```

- **`pattern`**
  A path pattern supporting 
  `*`
  , 
  `?`
  , and character classes such as 
  `[a-z]`
  .
  Wildcards do not cross directory separators. Recursive 
  `**`
   matching is not supported.

Returns a sorted list of matching paths, or an empty list if nothing matches.
Relative patterns return paths relative to the script's working directory;
absolute patterns return absolute paths. Returned paths use forward slashes.
Hidden files are included when they match. Invalid patterns fail; directory
read errors are ignored, matching Go's filesystem glob behavior.

```python
for path in fs.glob(".claude/agents/*.md"):
    print(path)
```

Relative paths resolve against the script's working directory, including when
called from a loaded module. Absolute paths are used as given. These functions
inspect the local filesystem; they do not isolate access to the repository.
Calls honor cancellation before and after the filesystem operation.

See [reading files](/functions/automation/fs.read_file) and
[Git hooks](/cli/configuration/git#local-git-hooks).