rename-pdfs-exe

name	rename-pdfs-exe
description	[Production] Rename PDF files using the compiled autorename-pdf-cli.exe. Windows only.
user-invocable	true
argument-hint	[path_to_pdfs]
allowed-tools	["Bash(autorename-pdf*)"]

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

1. Always dry-run first to preview changes:

   autorename-pdf-cli.exe rename $ARGUMENTS --dry-run --output json
   

2. Review the output — check that company names, dates, and document types look correct.

3. If the user confirms, run without dry-run:

   autorename-pdf-cli.exe rename $ARGUMENTS --output json
   

4. Report results — show renamed count, any failures, and new filenames.

Options

Pass these after the path:

• --recursive or -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.yaml next to the EXE (set up by setup.ps1)
• Company names file: harmonized-company-names.yaml next 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