Verify osxphotos is installed and the Photos library can be opened

Get high-level stats about the Photos library: counts of photos, movies, albums, folders, keywords, and persons

Search the Photos library. Combine filters (album, keyword, person, date range, favorite, hidden, photo/movie type, title/description substrings) to narrow results. Returns photo summaries with UUIDs — use get-photo for full details on a specific match.

Get full metadata for a single photo by UUID — dimensions, dates, location, place, albums, keywords, persons, labels, and type flags (HDR/live/raw/edited/etc.)

List all albums in the library, including their folder paths and photo counts

List all folders in the library with their parent and album/subfolder counts

List keywords sorted by usage count. Use limit to cap.

List people detected by Photos face recognition, sorted by photo count

Export one or more photos (by UUID) to a destination directory. By default exports the original. Use edited=true to export the edited version, live=true to include the live-photo video, raw=true to include the raw image. If an original isn't on disk (iCloud-only), the export falls back to Photos.app to download it on demand — same behavior as opening the photo in Photos. This can be slow for large batches; expect waits proportional to download size.