renamed pdf-split
Split multi-page PDFs intelligently. AI detects document boundaries within bundled files and splits them with proper naming.
renamed pdf-split <file> [options]The pdf-split command handles multi-document PDFs — the kind vendors send as bundled invoices or scanned document batches. It uses AI to find where each document starts and ends.
Split Modes
smartdefaultAI analyzes content to detect document boundaries. Best for scanned bundles.
every-n-pagesSplit every N pages. Use with --pages-per-split.
by-bookmarksSplit at PDF bookmark boundaries. Works with structured documents.
Examples
Smart split with auto-organization:
$ renamed pdf-split vendor-bundle.pdf --mode smart --organize --renameExtract specific page ranges:
$ renamed pdf-split document.pdf --mode pages --pages "1-5,10-20"Preview without creating files:
$ renamed pdf-split bundle.pdf --dry-runOptions
-m, --mode <type>Split mode: smart, every-n-pages, by-bookmarks. Default: smart.
-o, --output-dir <path>Directory for output files. Default: same as input.
-i, --instructions <text>Custom AI instructions for detecting document boundaries.
-n, --pages-per-split <n>Number of pages per split for every-n-pages mode. Default: 1.
-w, --waitWait for processing to complete before returning (sync mode).
--organizeSort output into folders by document type (invoices/, contracts/, etc).
--renameGenerate AI-powered filenames for split documents.
--dry-runPreview the split without creating files.
Output
AI analyzing 156-page document...
Found 23 documents:
8 invoices → ./invoices/
6 contracts → ./contracts/
5 receipts → ./receipts/
4 statements → ./statements/
Split complete in 4.2s