Cursor Remarkable Upload

Overview

Safely convert .md to .pdf and upload to a reMarkable device, defaulting to dry-runs and avoiding overwrites.

Preconditions

1. Confirm uploader exists: python3 /home/manuel/.local/bin/remarkable_upload.py --help
2. Confirm dependencies if needed: rmapi, pandoc, xelatex

Workflow (safe default)

1. Choose markdown file(s) (use absolute paths).
2. Dry-run:
   • python3 /home/manuel/.local/bin/remarkable_upload.py --dry-run /abs/path/to/doc.md
3. Upload (no overwrite):
   • python3 /home/manuel/.local/bin/remarkable_upload.py /abs/path/to/doc.md
4. 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.