Rename PDFs (Production EXE)
Rename PDF files using the installed autorename-pdf-cli.exe. Assumes the EXE is on PATH or in the current directory (installed via setup.ps1 from the release ZIP).
Workflow
Always dry-run first to preview changes:
autorename-pdf-cli.exe rename $ARGUMENTS --dry-run --output jsonReview the output — check that company names, dates, and document types look correct.
If the user confirms, run without dry-run:
autorename-pdf-cli.exe rename $ARGUMENTS --output jsonReport results — show renamed count, any failures, and new filenames.
Options
Pass these after the path:
--recursiveor-r— process subfolders--provider <name>— override AI provider (openai/anthropic/gemini/xai/ollama)--model <name>— override AI model--vision— force vision mode (send page images to LLM)--text-only— text extraction only, no OCR/vision--ocr— force PaddleOCR
Undo
autorename-pdf-cli.exe undo --output json
Config
autorename-pdf-cli.exe config show --output json
Company Name Harmonization
harmonized-company-names.yaml (next to the EXE) maps company name variations to standardized names (e.g., "MSFT", "Microsoft Corp." → "Microsoft"). Uses fuzzy matching (Jaro-Winkler) so OCR typos are handled automatically.
If the dry-run output shows inconsistent or wrong company names, suggest the user add mappings:
StandardName:
- "Variation 1"
- "Variation 2"
Notes
- Config file:
config.yamlnext to the EXE (set up bysetup.ps1) - Company names file:
harmonized-company-names.yamlnext to the EXE (copy from.example) - The GUI app (
autorename-pdf-gui.exe) is the primary way to use this tool — this skill is for CLI/automation use cases - Output format:
YYYYMMDD COMPANY DOCTYPE.pdf - Windows only
Source: ptmrio/autorename-pdf — distributed by TomeVault.