AI SCREENSHOT ORGANIZER
Mar 2026 - Present • CLI
SNAPSHOT
CLI tool that uses a vision LLM to analyze screenshots, classify them into practical categories, persist metadata in SQLite, and produce a filterable report (grid/table) with Finder shortcuts.
THE PROBLEM
Large screenshot folders become hard to search and maintain. Manual sorting is repetitive, inconsistent, and usually skips useful metadata like what the screenshot contains.
THE RESULT
Built a working AI-powered CLI that auto-categorizes screenshots, renames/moves them into structured folders, stores searchable metadata in SQLite, and generates an interactive HTML report for quick review.
HOW IT WORKS
AI Screenshot Organizer is a Python CLI-first utility designed to reduce screenshot clutter. It scans image files, sends each to a vision-capable LLM through LiteLLM, parses structured JSON output with fallback-safe parsing strategies, and moves files into category folders with collision-safe naming. Each item is saved to SQLite with batch IDs and timestamps, enabling filtered retrieval by category, search term, and run. The project also ships a self-contained HTML visualizer with grid/table modes, category filter pills, and local file links for fast triage. Runtime workspace management and environment key handling are built into the CLI to keep setup simple across providers.