| name | cursor-remarkable-upload |
| description | Upload markdown (including docmgr ticket docs) to a reMarkable device as PDF via a local uploader script, with a safe dry-run and optional mirroring of ticket structure. Use when the user asks to send docs to reMarkable, export markdown to PDF for reMarkable, or troubleshoot rmapi/pandoc/xelatex. |
Cursor Remarkable Upload
Overview
Safely convert .md to .pdf and upload to a reMarkable device, defaulting to dry-runs and avoiding overwrites.
Preconditions
- Confirm uploader exists:
python3 /home/manuel/.local/bin/remarkable_upload.py --help
- Confirm dependencies if needed:
rmapi, pandoc, xelatex
Workflow (safe default)
- Choose markdown file(s) (use absolute paths).
- Dry-run:
python3 /home/manuel/.local/bin/remarkable_upload.py --dry-run /abs/path/to/doc.md
- Upload (no overwrite):
python3 /home/manuel/.local/bin/remarkable_upload.py /abs/path/to/doc.md
- Only if explicitly requested: overwrite with
--force.
Ticket-aware uploads
- Prefer mirroring ticket structure to avoid name collisions; see
references/remarkable.md.
Reference
- Full usage + troubleshooting:
references/remarkable.md.
