# remarkable-upload

> Upload Markdown and source files to a reMarkable device as PDFs using the remarquee CLI (rmapi-backed). Use when the user asks to upload/send/export docs/examples to reMarkable, bundle multiple files into one PDF with a ToC, choose an /ai/YYYY/MM/DD destination, avoid or force overwrites, or troubleshoot pandoc/xelatex/rmapi auth.

- Author: Manuel Odendahl
- Repository: wesen/skills
- Version: 20260202205459
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/wesen/skills
- Web: https://mule.run/skillshub/@@wesen/skills~remarkable-upload:20260202205459

---

---
name: remarkable-upload
description: Upload Markdown and source files to a reMarkable device as PDFs using the remarquee CLI (rmapi-backed). Use when the user asks to upload/send/export docs/examples to reMarkable, bundle multiple files into one PDF with a ToC, choose an /ai/YYYY/MM/DD destination, avoid or force overwrites, or troubleshoot pandoc/xelatex/rmapi auth.
---

# Remarkable Upload

## Preconditions

1. Confirm `remarquee` exists:
   - `remarquee status`
2. Confirm PDF tooling if needed:
   - `pandoc`, `xelatex`
3. Confirm cloud auth if needed:
   - `remarquee cloud account --non-interactive` (or run without `--non-interactive` to complete one-time code)

## Workflow (safe default, recommended)

1. Choose inputs (use absolute paths when possible).
2. Dry-run first:
   - Single/many markdown: `remarquee upload md --dry-run <path...>`
   - Bundled markdown (one PDF + ToC): `remarquee upload bundle --dry-run <path...>`
   - Source code PDFs: `remarquee upload src --dry-run <path...>`
3. Upload (no overwrite):
   - Same commands without `--dry-run`
4. Overwrite only if explicitly requested (WARNING: deletes existing document + annotations):
   - add `--force`

## Bundling multiple files (preferred)

- Bundle multiple markdown inputs into a single PDF with a clickable ToC:
  - `remarquee upload bundle <path...> --name "<doc name>" --remote-dir "/ai/YYYY/MM/DD/<folder>" --toc-depth 2`
- Bundle multiple source files into a single syntax-highlighted PDF:
  - `remarquee upload src <path...> --bundle --include-ext .go --name "<doc name>" --remote-dir "/ai/YYYY/MM/DD/<folder>" --toc-depth 2`

Tip: if you care about ToC order and titles, copy/rename files into a temp folder with numeric prefixes, then pass that directory to `bundle`.

## Ticket-aware uploads (recommended)

- Put uploads under a stable ticket folder (avoids collisions):
  - Remote: `/ai/YYYY/MM/DD/<TICKET-ID>/`
  - Use `--date YYYY/MM/DD` (or `--remote-dir ...`) explicitly.
- Verify results:
  - `remarquee cloud ls /ai/YYYY/MM/DD/<TICKET-ID> --long --non-interactive`

## Legacy fallback (only if needed)

If `remarquee` is unavailable, the older uploader script can still be used:

- Dry-run: `python3 /home/manuel/.local/bin/remarkable_upload.py --dry-run /abs/path/to/doc.md`
- Upload: `python3 /home/manuel/.local/bin/remarkable_upload.py /abs/path/to/doc.md`
- Overwrite: `python3 /home/manuel/.local/bin/remarkable_upload.py --force /abs/path/to/doc.md`

## Reference

- Full guide + troubleshooting: `references/remarkable.md`