list_s3_recursive
Recursively list all files in an S3 bucket or folder with optional filtering by name, extension, or environment to obtain complete file inventories and summaries.
Instructions
Recursively list ALL files under an S3 bucket/prefix in a single call.
USE THIS TOOL when the user asks to see everything in a bucket or folder end-to-end, wants a full file listing, or needs to find files by name or extension across nested folders.
Args: bucket: S3 bucket name (required). prefix: Starting prefix/folder (default: root of bucket). Example: 'raw/hem_processing/' to list that subtree. name_filter: Optional — case-insensitive substring match on filename. Example: 'taxonomy' shows only files with 'taxonomy' in the name. extension_filter: Optional — file extension to filter by (with or without dot). Example: '.csv' or 'csv' or '.parquet' or '.gz' max_results: Max files to return (default 500, max 2000). env: Target environment — 'dev', 'uat', 'test', or 'prod'. IMPORTANT: Do NOT guess or default. Ask the user which environment if not specified.
Returns a full recursive file listing with sizes, plus a summary with total count, total size, and file type breakdown.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket | Yes | ||
| prefix | No | ||
| name_filter | No | ||
| extension_filter | No | ||
| max_results | No | ||
| env | No |