| name | pdf-editor |
| description | Edit, annotate, extract, merge, and transform PDF files using nano-pdf with natural language instructions. Use when user needs to modify PDF content, extract text, merge documents, add annotations, or convert PDFs.
|
| allowed-tools | ["Bash","Read","Write"] |
| model | haiku |
| user-invocable | true |
| when_to_use | When user needs to work with PDF files — editing, extracting text, merging, splitting, annotating, converting, or filling forms. Triggers: "edit PDF", "extract text from PDF", "merge PDFs", "split PDF", "add annotation", "fill PDF form", "convert PDF to...", "compress PDF".
|
| argument-hint | <action: extract|merge|split|annotate|fill|convert|compress> <file.pdf> <details> |
PDF Editor
Edit and process PDF files using nano-pdf, a natural language PDF editing tool.
Prerequisites
pip install nano-pdf
Or with pipx for isolated install:
pipx install nano-pdf
Verify:
nano-pdf --version
Commands
| Command | Description |
|---|
nano-pdf extract <file.pdf> | Extract all text from a PDF |
nano-pdf extract <file.pdf> --pages 1-5 | Extract specific pages |
nano-pdf merge <a.pdf> <b.pdf> -o output.pdf | Merge two or more PDFs |
nano-pdf split <file.pdf> --pages 1-3 -o part1.pdf | Split out specific pages |
nano-pdf annotate <file.pdf> --page 2 --text "Review this" | Add text annotation |
nano-pdf fill <form.pdf> --field "Name=Alice" --field "Date=2026-03-21" | Fill form fields |
nano-pdf convert <file.pdf> --to txt -o output.txt | Convert to text |
nano-pdf convert <file.pdf> --to html -o output.html | Convert to HTML |
nano-pdf compress <file.pdf> -o compressed.pdf | Compress/optimize PDF |
nano-pdf info <file.pdf> | Show metadata (pages, author, title) |
nano-pdf rotate <file.pdf> --pages all --degrees 90 -o rotated.pdf | Rotate pages |
Usage Examples
Extract text for reading:
nano-pdf extract report.pdf > workspace/report-text.txt
Merge multiple PDFs:
nano-pdf merge cover.pdf chapter1.pdf chapter2.pdf -o final.pdf
Split out pages 5–10:
nano-pdf split document.pdf --pages 5-10 -o excerpt.pdf
Fill a PDF form:
nano-pdf fill application.pdf \
--field "FirstName=Alice" \
--field "LastName=Smith" \
--field "Date=2026-03-21" \
-o filled-application.pdf
Get PDF metadata:
nano-pdf info contract.pdf
Rules
- Always check if CLI is installed first:
which nano-pdf or nano-pdf --version
- If not installed, show
pip install nano-pdf and stop
- Always verify the input file exists before running any command
- When extracting large PDFs (> 50 pages), save output to
workspace/ rather than displaying inline
- For merge operations, list the input files in order and confirm with the user before executing
- For fill operations, first use
nano-pdf info to list available form fields before filling
- Output files default to the same directory as input unless user specifies otherwise — prefer saving to
workspace/ for intermediate results
- Keep responses concise: confirm action and output path in 1-2 lines
- For large files, note the page count and file size in the confirmation
