dl-organizer/skills/vlm-library-workflow/references/cli-reference.md

VLM CLI Reference

Configuration

• vlm config init: Create default config.
• vlm config show: Display current settings.
• vlm config validate: Check config for errors.

Core Commands

• vlm scan [--output PATH]: Discover video files.
• vlm parse [--input CSV] [--output JSON] [--inventory CSV]: Parse filenames.
• vlm enrich [--input JSON] [--output JSON] [--refresh-all]: Fetch TMDB metadata.
• vlm analyze [--input JSON] [--output JSON]: Find gaps and duplicates.
• vlm plan [--input JSON] [--analysis JSON] [--output JSON]: Generate operations.
• vlm execute [--plan JSON] [--confirm]: Move/Rename files.
• vlm rollback [--log PATH]: Undo operations.

Management & Reporting

• vlm quarantine list|add|restore: Manage the .quarantine directory.
• vlm report inventory|completeness|duplicates|summary: Generate human-readable reports.
• vlm state show|set|query|clear: Track manual review status for files.

Important Config Options (~/.vlm/config.yaml)

• library_root: Path to the video collection.
• templates: Naming patterns for movies and series.
• plan.duplicate_keep: Strategy for duplicates (by_quality, by_reputation, first_seen, manual).
• enrichment.api_keys: TMDB and OpenAI keys.