list_files - Augent

Example

Request:

{
  "directory": "~/Downloads"
}

Response:

{
  "directory": "/Users/you/Downloads",
  "count": 3,
  "files": [
    { "path": "/Users/you/Downloads/episode1.webm", "name": "episode1.webm", "size_mb": 14.5 },
    { "path": "/Users/you/Downloads/episode2.mp4", "name": "episode2.mp4", "size_mb": 8.2 },
    { "path": "/Users/you/Downloads/podcast.mp3", "name": "podcast.mp3", "size_mb": 22.1 }
  ]
}

Parameters

Parameter	Required	Default	Description
`directory`	Yes	—	Directory path to search
`pattern`	No	all common media formats	Glob pattern for matching files (e.g. `"*.wav"`)
`recursive`	No	`false`	Search subdirectories

Notes

Default formats: .mp3, .m4a, .wav, .webm, .mp4, .mkv, .ogg, .flac

Use pattern to override with a custom glob (e.g. "*.wav").

Use recursive: true to search subdirectories.