---
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

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`.