| 1 | --- |
| 2 | name: photos |
| 3 | description: Search and export the macOS Photos library. Use when: photos, photo library, pictures, find a photo, or media library. |
| 4 | invocation: model+user |
| 5 | --- |
| 6 | |
| 7 | # Photos |
| 8 | |
| 9 | ## When to use |
| 10 | Finding pictures in the user's Mac photo library by date, place, person, |
| 11 | album, or keyword — and exporting copies elsewhere. |
| 12 | |
| 13 | ## Setup |
| 14 | Requires `osxphotos` (`pip install osxphotos`) and a local Photos library. |
| 15 | Fail loud when either is missing. Full Disk Access may be needed for the |
| 16 | terminal on first use — say so when queries return nothing. |
| 17 | |
| 18 | ## Workflow |
| 19 | 1. Query, don't browse: `osxphotos query --json --added-before/after ...` |
| 20 | with the narrowest date/place/person filter the question allows. |
| 21 | 2. Report counts first; export only what the user asked for: |
| 22 | `osxphotos export /path --query ...`. |
| 23 | 3. Describe image contents from the files, never from filenames alone. |
| 24 | |
| 25 | ## Non-goals |
| 26 | - Do not modify or delete library photos. |
| 27 | - Do not upload photos anywhere. |
| 28 | - Do not run face recognition beyond what Photos already computed. |
| 29 |