renamed rename
AI-powered file renaming. Analyzes document content to generate descriptive, searchable filenames automatically.
renamed rename <path> [options]The rename command scans files and uses AI to understand their content. It extracts dates, company names, amounts, document types, and other metadata to create clean, consistent filenames.
By default, it runs in dry-run mode — showing what would change without modifying files. Add --apply to execute the renames.
Examples
Preview changes (safe, no modifications):
$ renamed rename ./documents/Apply the renames:
$ renamed rename ./documents/ --applyRename and move to organized folders:
$ renamed rename ./incoming/ --apply --output-dir ~/OrganizedProcess only PDFs, recursively:
$ renamed rename ./docs/ --pattern "*.pdf" -r --applyOptions
-a, --applyExecute the renames. Without this flag, runs in preview mode.
-o, --output-dir <path>Move renamed files to a different directory. AI will organize into subfolders.
-s, --strategy <strategy>Folder organization strategy. See strategies below.
-t, --template <template>Filename template format. See templates below.
-p, --prompt <text>Custom AI instructions for generating filenames.
-l, --language <lang>Preferred language for generated filenames (e.g., en, de, fr).
--overwriteOverwrite existing files with the same name.
-r, --recursiveProcess files in subdirectories.
--concurrency <n>Process n files in parallel. Default: 4.
-v, --verboseShow detailed processing output.
Organization Strategies
by_date — Organize by year/month (e.g., 2026/01/file.pdf)
by_issuer — Organize by company/sender name
by_type — Organize by document type (invoices/, receipts/, contracts/)
by_date_issuer — Combine date and issuer (e.g., 2026/AcmeCorp/file.pdf)
by_date_type — Combine date and type
by_issuer_type — Combine issuer and type
by_all — Full hierarchy (date/issuer/type)
root — No subfolders, keep files in output directory
follow_custom_prompt — Let AI decide based on your custom prompt
Filename Templates
standard — Balanced format: 2026-01-15_AcmeCorp_Invoice_INV-001.pdf
date_first — Date-focused: 2026-01-15_Invoice_AcmeCorp.pdf
company_first — Company-focused: AcmeCorp_2026-01-15_Invoice.pdf
minimal — Short format: 2026-01-15_Invoice.pdf
detailed — Full metadata: 2026-01-15_AcmeCorp_Invoice_INV-001_$2450.pdf
department_focus — Department-centric naming
Output
Analyzing 47 files...
✓ IMG_4521.pdf
→ 2026-01-15_AcmeCorp_Invoice_INV-8847.pdf
✓ scan0042.pdf
→ 2026-01-14_Receipt_Starbucks_$12.50.pdf
✓ document.pdf
→ 2026-01-13_Contract_NDA_TechCorp.pdf
Done! 47 files renamed in 2.3s