remarkable

name	remarkable
description	Fetch handwritten notes, sketches, and drawings from a reMarkable tablet via Cloud API (rmapi). Process content by refining artwork with AI image generation, extracting handwritten text to memory/journal, or using sketches as input for other workflows. Use when working with reMarkable tablet content, syncing handwritten notes, processing sketches, or integrating tablet drawings into projects.

reMarkable Tablet Integration (rmapi)

Fetch handwritten notes, sketches, and drawings from a reMarkable tablet via Cloud API. Process them — refine artwork with AI image generation, extract text to memory/journal, or use as input for other workflows.

Typical Use Cases

1. Journal entries — User writes thoughts on reMarkable → fetch → OCR/interpret → append to memory/YYYY-MM-DD.md or a dedicated journal file
2. Sketch refinement — User draws a rough graphic → fetch → enhance with nano-banana-pro (AI image editing) → return polished version
3. Brainstorming/notes — User jots down ideas, lists, diagrams → fetch → extract structure → add to project docs or memory
4. Illustrations — User creates hand-drawn art → fetch → optionally stylize → use in blog posts, social media, etc.

Processing Pipeline

reMarkable tablet → Cloud sync → rmapi fetch → PDF/PNG
                                                  ↓
                                    ┌─────────────┴─────────────┐
                                    │                           │
                              Text content?               Visual/sketch?
                                    │                           │
                              OCR / interpret            nano-banana-pro
                                    │                     (AI enhance)
                                    │                           │
                              Add to memory/            Return refined
                              journal/project            image to user

Setup

• Tool: rmapi (ddvk fork) v0.0.32
• Binary: ~/bin/rmapi
• Config: ~/.rmapi (device token after auth)
• Sync folder: ~/clawd/remarkable-sync/

Authentication (ONE-TIME)

1. User goes to https://my.remarkable.com/connect/desktop
2. Logs in, gets 8-character code
3. Run rmapi and enter the code
4. Token saved to ~/.rmapi — future runs are automatic

Commands

# List files/folders
rmapi ls
rmapi ls --json

# Navigate
rmapi cd "folder name"

# Find by tag / starred / regex
rmapi find --tag="share-with-gandalf" /
rmapi find --starred /
rmapi find / ".*sketch.*"

# Download (PDF)
rmapi get "filename"

# Download with annotations rendered (best for sketches)
rmapi geta "filename"

# Bulk download folder
rmapi mget -o ~/clawd/remarkable-sync/ "/Shared with Gandalf"

Sharing Workflows

Option A: Dedicated Folder

User creates "Shared with Gandalf" folder on reMarkable → moves items there → agent fetches with rmapi mget

Option B: Tag-Based

User tags documents with share-with-gandalf → agent discovers with rmapi find --tag

Option C: Starred Items

User stars items → agent fetches with rmapi find --starred

Fetch Script

# Fetch from shared folder
~/clawd/scripts/remarkable-fetch.sh

# Fetch starred items
~/clawd/scripts/remarkable-fetch.sh --starred

# Fetch by tag
~/clawd/scripts/remarkable-fetch.sh --tag="share-with-gandalf"

Notes

• Tablet must cloud-sync before files are available
• geta renders annotations into PDF (preferred for handwritten content)
• Use convert (ImageMagick) to go from PDF → PNG for image processing
• For text extraction, interpret the handwriting visually (vision model) rather than traditional OCR