Show HN: AI-rganize: Just another file/folder organizing AI terminal tool (github.com)

ai-rganize is an open-source, cross-platform CLI tool (macOS, Linux, Windows) that uses OpenAI GPT to automatically categorize and move files into logical folders (Documents, Images, Videos, Audio, Code, Archives, etc.). It offers a clean terminal interface, dry-run previews, automatic timestamped backups (~/.ai-rganize_backup/), logging (~/.ai-rganize_log.json), permission checks, duplicate and error handling, and rule-based fallbacks for large files. The project ships with sensible safety controls—dry-run, backup-by-default, max-file-size (default 10 MB), ai-limit (default 50 files) and batch/cost controls—so you can experiment without immediately changing your filesystem. It’s MIT-licensed and expects Python 3.7+, OpenAI API access, and optional ffmpeg for media inspection. For developers and power users, ai-rganize integrates with uv (faster project/venv/dependency management) and supports choosing OpenAI models (gpt-4, gpt-4o-mini, gpt-3.5-turbo) to balance cost vs. quality; future LLM providers (Claude, Gemini) are planned. Important technical implications: file content and metadata are sent to the LLM (privacy and API-cost considerations), large files are handled rule-based to limit costs, and configuration flags let you tune batch size and max-cost. The recommended workflow is to run --dry-run, review the plan and backups, then run with full permissions if satisfied.