Files
6f0df5a774 release: v0.2.0 repository hygiene, CI, and docs sync
Stop tracking personal workflow artifacts at repo root, add CI and MIT
license, align README and agent skills with artifacts/ defaults, and
enable Ruff in dev/CI so releases are verifiable without local-only runs.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-01 15:32:03 +08:00

1.7 KiB

Documentation Status

  • Updated to current CLI options on 2026-06-01. Default artifact paths are under artifacts/.

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 review-plan [--input JSON] [--output CSV] [--tui]: Export manual review CSV (optional Textual UI).
  • vlm apply-review [--plan JSON] [--csv PATH]: Sync edited review CSV into plan.
  • vlm execute [--plan JSON] [--confirm] [--yes] [--verbose-ops] [--safe-mode] [--preserve-directories]: Move/Rename/Quarantine operations with safety guards.
  • 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, by_reputation_quality_time, first_seen, manual).
  • enrichment.api_keys: TMDB and OpenAI keys.