# Send reMarkable Tablet Sync to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "remarkable-sync",
    "name": "reMarkable Tablet Sync",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/coolmanns/remarkable-sync",
    "canonicalUrl": "https://clawhub.ai/coolmanns/remarkable-sync",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/remarkable-sync",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=remarkable-sync",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "remarkable-sync",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-12T14:18:41.050Z",
      "expiresAt": "2026-05-19T14:18:41.050Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=remarkable-sync",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=remarkable-sync",
        "contentDisposition": "attachment; filename=\"remarkable-sync-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "remarkable-sync"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/remarkable-sync"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/remarkable-sync",
    "downloadUrl": "https://openagent3.xyz/downloads/remarkable-sync",
    "agentUrl": "https://openagent3.xyz/skills/remarkable-sync/agent",
    "manifestUrl": "https://openagent3.xyz/skills/remarkable-sync/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/remarkable-sync/agent.md"
  }
}
```
## Documentation

### reMarkable Tablet Integration (rmapi)

Bidirectional sync with reMarkable tablet via Cloud API. Fetch sketches and notes, process them (AI enhancement, text extraction), and push content back to the tablet.

### Typical Use Cases

Sketch → AI → Tablet loop — Fetch rough sketch → enhance with AI → push polished version back
Journal entries — Fetch handwritten thoughts → interpret → append to memory/journal
Brainstorming — Fetch diagrams/lists → extract structure → add to project docs
Send reading material — Push PDFs/documents to tablet for offline reading
AI art to tablet — Generate images → convert to PDF → push for viewing on e-ink

### Bidirectional Pipeline

┌─────────────────────────────────────────────────────────────────┐
│                        FETCH (tablet → agent)                    │
├─────────────────────────────────────────────────────────────────┤
│  reMarkable → Cloud sync → rmapi get → .rmdoc                   │
│                                           ↓                      │
│                              unzip → .rm file → rmc → SVG       │
│                                                      ↓           │
│                                          cairosvg → PNG          │
│                                                      ↓           │
│                               ┌──────────┴──────────┐            │
│                          Text content?         Visual/sketch?    │
│                               ↓                      ↓           │
│                        OCR/interpret          AI image editing   │
│                               ↓                      ↓           │
│                        Add to memory        Enhanced image       │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│                        PUSH (agent → tablet)                     │
├─────────────────────────────────────────────────────────────────┤
│  Image/document → Convert to PDF (if needed) → rmapi put        │
│                                                      ↓           │
│                                           Cloud sync → tablet    │
└─────────────────────────────────────────────────────────────────┘

### 1. Install rmapi

Download the latest release from juruen/rmapi (ddvk fork recommended):

# Example for Linux amd64
curl -L https://github.com/ddvk/rmapi/releases/latest/download/rmapi-linux-amd64 -o ~/bin/rmapi
chmod +x ~/bin/rmapi

### 2. Install conversion tools

pip install --user rmc cairosvg pillow

rmc — Converts .rm stroke files to SVG
cairosvg — Converts SVG to PNG
pillow — Converts PNG to PDF for pushing back

### 3. Authenticate (ONE-TIME)

Go to https://my.remarkable.com/connect/desktop
Log in and copy the 8-character code
Run rmapi and paste the code when prompted
Token saved to ~/.rmapi — future runs are automatic

### Fetch (Download from tablet)

# List files/folders
rmapi ls
rmapi ls -l -t              # Long format, sorted by time

# Refresh from cloud
rmapi refresh

# Navigate
rmapi cd "folder name"

# Find files
rmapi find --starred /              # Starred items
rmapi find --tag="my-tag" /         # By tag
rmapi find / ".*sketch.*"           # By regex

# Download single file
rmapi get "filename"
rmapi get "Folder/Notebook"

# Download with annotations (best for handwritten content)
rmapi geta "filename"

# Bulk download folder
rmapi mget -o ./sync-folder/ "/My Folder"

### Push (Upload to tablet)

# Upload single file (PDF or EPUB only)
rmapi put document.pdf
rmapi put document.pdf "Target Folder/"

# Bulk upload
rmapi mput ./local-folder/ "Remote Folder/"

# Create folder on tablet
rmapi mkdir "New Folder"

Supported formats: PDF, EPUB

### Fetch: .rmdoc → PNG

reMarkable notebooks download as .rmdoc (a ZIP archive containing stroke data):

# 1. Download the notebook
rmapi get "Folder/MyNotebook"

# 2. Extract (it's a zip)
unzip "MyNotebook.rmdoc" -d extracted/

# 3. Find the .rm stroke file(s)
# Structure: extracted/<doc-uuid>/<page-uuid>.rm
find extracted -name "*.rm"

# 4. Convert .rm → SVG
rmc -t svg -o page.svg "extracted/<doc-uuid>/<page-uuid>.rm"

# 5. Convert SVG → PNG (reMarkable dimensions: 1404×1872)
python3 -c "
import cairosvg
cairosvg.svg2png(url='page.svg', write_to='page.png', output_width=1404, output_height=1872)
"

### Push: Image → PDF

reMarkable only accepts PDF/EPUB, so convert images first:

from PIL import Image

img = Image.open('image.png')
rgb = img.convert('RGB')
rgb.save('image.pdf', 'PDF', resolution=150)

Then push:

rmapi put image.pdf "My Folder/"

### Full Workflow Example

Sketch enhancement loop:

# 1. Fetch sketch from tablet
rmapi get "Sketches/MyDrawing"

# 2. Extract and convert to PNG
unzip MyDrawing.rmdoc -d MyDrawing_extracted/
RM_FILE=$(find MyDrawing_extracted -name "*.rm" | head -1)
rmc -t svg -o sketch.svg "$RM_FILE"
python3 -c "import cairosvg; cairosvg.svg2png(url='sketch.svg', write_to='sketch.png', output_width=1404, output_height=1872)"

# 3. [Your AI enhancement step here]
# Example: use any image-to-image AI tool to enhance sketch.png → enhanced.png

# 4. Convert to PDF and push back
python3 -c "from PIL import Image; Image.open('enhanced.png').convert('RGB').save('enhanced.pdf', 'PDF', resolution=150)"
rmapi put enhanced.pdf "Sketches/"

### Sharing Strategies

Create a dedicated sync folder on your tablet, or use:

Tags — Tag items for discovery with rmapi find --tag
Stars — Star items for quick access with rmapi find --starred

### Notes

Cloud sync required — Tablet must sync to cloud before files are available (pull down to refresh on tablet)
Format — .rmdoc is a ZIP containing JSON metadata + .rm binary stroke files
Warnings — rmc may show warnings about newer format versions — usually still works
Dimensions — reMarkable display is 1404×1872 pixels (portrait)
Text extraction — For handwritten text, use vision models to interpret visually rather than traditional OCR

### Troubleshooting

IssueSolutionrmapi not connectingRe-authenticate: delete ~/.rmapi and run rmapi againFile not found after uploadWait for cloud sync, or refresh tablet manuallyrmc format warningsUsually safe to ignore; output still generatedSVG looks emptyCheck if the correct .rm file was used (multi-page notebooks have multiple)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: coolmanns
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-12T14:18:41.050Z
- Expires at: 2026-05-19T14:18:41.050Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/remarkable-sync)
- [Send to Agent page](https://openagent3.xyz/skills/remarkable-sync/agent)
- [JSON manifest](https://openagent3.xyz/skills/remarkable-sync/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/remarkable-sync/agent.md)
- [Download page](https://openagent3.xyz/downloads/remarkable-sync)