name

Matches files by filename using glob patterns or regular expressions.

Syntax

# Glob pattern (shorthand)
- name: "*.txt"

# Glob pattern (explicit)
- name:
    glob: "report_*.pdf"

# Regular expression
- name:
    regex: "^file_\d{4}\.txt$"

Options

Only one of glob or regex can be specified.

Glob patterns

The glob pattern is matched against the base filename only (not the full path).

Examples

Match all text files

- name: "*.txt"

Match files starting with “report”

- name: "report*"

Match files with numbers in name

- name:
    regex: ".*\d+.*"

Match screenshot files

- name: "Screenshot*"

Exclude hidden files (macOS)

filters:
  - not:
      - any:
          - name: ".*"
          - name: .DS_Store