AI SummaryThis file provides guidance to AI coding assistants working with code in this repository. photo-cli is a .NET 10 CLI tool that reads EXIF metadata from photos, reverse-geocodes GPS coordinates via Google Maps / OpenStreetMap / BigDataCloud, and organizes photos into structured folders with SQLite st
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to add the "photo-cli — Windsurf Rules" prompt rules to my project. Repository: https://github.com/photo-cli/photo-cli Please read the repo to find the rules/prompt file, then: 1. Download it to the correct location (.cursorrules, .windsurfrules, .github/prompts/, or project root — based on the file type) 2. If there's an existing rules file, merge the new rules in rather than overwriting 3. Confirm what was added
Description
A photo organizer for your file system without sticking to any application or vendor. Extract when and where (reverse geocoding) your photos are taken, archive or copy into a new organized folder with various folder & file naming strategies with an album support to categorize, list & view easily with a metadata stored on local SQLite & CSV support.
Overview
photo-cli is a .NET 10 CLI tool that reads EXIF metadata from photos, reverse-geocodes GPS coordinates via Google Maps / OpenStreetMap / BigDataCloud, and organizes photos into structured folders with SQLite storage and CSV export. It also exposes an MCP server so LLMs can query archived photo metadata directly.
AGENTS.md
This file provides guidance to AI coding assistants working with code in this repository.
Repository Layout
` src/ — main executable (PhotoCli.csproj) McpTools/ — MCP server surface wrapping runners for LLM access Models/ — EF Core entities, enums, CSV DTOs, ArchiveDbContext Options/ — strongly-typed CLI argument classes per subcommand Validators/ — FluentValidation rules for each Options class Runners/ — one IConsoleRunner per subcommand Services/ Contracts/ — service interfaces Implementations/ — service implementations Utils/ — extensions, constants, path helpers, logging Program.cs — entry point: CommandLine parser + DI setup tests/ UnitTests/ — fast, fully mocked tests IntegrationTests/ — tests against real SQLite / file system EndToEndTests/ — full CLI invocation tests Fakes/ — fake implementations shared across test projects Utils/ — MockFileSystemHelper, MockHttpClient, etc. `
Build
dotnet build --configuration Release
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster
Works With
Any AI assistant that accepts custom rules or system prompts