- Added the MCP
view_photoandview_photos_by_*tools, which return downscaled JPEG images inline in the chat (Claude Desktop, claude.ai) on any platform; theopen_*tools still open full-resolution originals in macOS Preview. - Added the
skillcommand, which installs aphotocliagent skill into.claude/skills/photocliof the current folder (or into~/.claudewith--global) so AI agents can guide you through the options, verify the command with you, run it, and summarize the statistics.
- The
archivecommand now supports named and address-based album metadata linking to photos via--album-type,--album-name,--update-album, and--auto-reverse-geocode-album. - Added the
listcommand to browse, filter, and open photos from archived folders based on metadata (by album, exact date, or date range). - Added the
mcpcommand to run photo-cli as an MCP (Model Context Protocol) stdio server, exposing the photo archive to AI assistants. - Refactored console output with colours and table support for better readability.
- Added container (Docker, Podman) support.
- Reverse geocode caching now persists between archive runs.
- Customizable logging infrastructure with per-namespace log levels.
- Added
hifto the default supported photo extensions. - Added
--invalid-format,--missing-reverse-geocode,--expected-day-range, and--languagearguments across commands. - Upgraded the runtime to .NET 10.
- Added companion file support — files sharing the same base name as a photo (for example, Live Photo
.movfiles) are now copied and renamed alongside the photo. - Improved resilience in reverse geocoding requests; transient network errors are retried automatically.
- Upgraded the runtime to .NET 8.
- Supported photo extensions are now configurable via the
SupportedExtensionssetting.
- Fixed a bug that prevented setting non-string values (integers, booleans) through the
settingscommand.
- Added the
archiveverb for archiving photos with a date-hash naming scheme. - Reverse geocode results are now cached to avoid redundant API calls.
- Address responses from reverse geocode providers are now validated against a regex before use.
- Various small fixes and test improvements.
- Added HEIC and JPEG file support.
- Added file hash verification after copy (
--verifyflag). - Invalid photo formats are now caught, reported, and moved to a dedicated folder rather than causing a hard failure.
- Added the ability to retrieve an address from a photo without specifying provider-specific properties.
- Removed the MapQuest reverse geocode provider (service has been deprecated by the vendor).
First public release. Included the following verbs and options:Verbs:
copy, info, address, settingsFolderProcessType: Single, SubFoldersPreserveFolderHierarchy, FlattenAllSubFoldersNamingStyle: Numeric, Day, DateTimeWithMinutes, DateTimeWithSeconds, Address, DayAddress, DateTimeWithMinutesAddress, DateTimeWithSecondsAddress, AddressDay, AddressDateTimeWithMinutes, AddressDateTimeWithSecondsFolderAppendType: FirstYearMonthDay, FirstYearMonth, FirstYear, DayRange, MatchingMinimumAddressGroupByFolderType: YearMonthDay, YearMonth, Year, AddressFlat, AddressHierarchyReverseGeocodeProvider: BigDataCloud, OpenStreetMapFoundation, GoogleMaps, MapQuest, LocationIq