SPANISH FLU 2652109d7f feat: add reMarkable tablet skill and setup guide

Add skill for managing documents on reMarkable tablets via SSH:
- Upload PDFs and EPUBs to device library
- List documents with UUIDs
- Delete documents by name or UUID

Also includes docs/guides/remarkable-integration.md with full
Tailscale setup instructions for remote access.

Tested on reMarkable 2, OS 3.24.0.149.

2026-01-26 23:58:55 +01:00

2.2 KiB

Raw Blame History

name

description

metadata

remarkable

Manage documents on reMarkable tablets via SSH. Upload PDFs/EPUBs, list library, delete documents. Requires Tailscale or direct SSH access to the device.

clawdbot

emoji

requires

📓

bins

ssh

scp

reMarkable

Manage documents on reMarkable tablets over SSH.

Prerequisites

SSH access to reMarkable via Tailscale (recommended) or local network. Add to ~/.ssh/config:

Host rem
  HostName <TAILSCALE_IP>
  User root
  StrictHostKeyChecking no
  UserKnownHostsFile /dev/null

Test: ssh rem echo ok

Document Paths

Library: /home/root/.local/share/remarkable/xochitl/
Documents: <uuid>.pdf + <uuid>.metadata + <uuid>.content
Restart UI after changes: systemctl restart xochitl

Upload PDF/EPUB

# Copy file
scp document.pdf rem:/home/root/

# Create document entry
ssh rem 'cd /home/root/.local/share/remarkable/xochitl && \
  UUID=$(cat /proc/sys/kernel/random/uuid) && \
  cat > ${UUID}.metadata << EOF
{
    "createdTime": "'$(date +%s)'000",
    "lastModified": "'$(date +%s)'000",
    "lastOpened": "0",
    "lastOpenedPage": 0,
    "parent": "",
    "pinned": false,
    "type": "DocumentType",
    "visibleName": "My Document Title"
}
EOF
cp /home/root/document.pdf ${UUID}.pdf && \
echo "{}" > ${UUID}.content && \
systemctl restart xochitl'

Adjust visibleName and source filename as needed.

List Documents

ssh rem 'grep -h visibleName /home/root/.local/share/remarkable/xochitl/*.metadata 2>/dev/null | sed "s/.*: \"//" | sed "s/\".*//"'

With UUIDs:

ssh rem 'for f in /home/root/.local/share/remarkable/xochitl/*.metadata; do echo "$(basename $f .metadata): $(grep visibleName $f | sed "s/.*: \"//" | sed "s/\".*//")" ; done 2>/dev/null'

Delete Document

# Find UUID by name
ssh rem 'grep -l "Document Name" /home/root/.local/share/remarkable/xochitl/*.metadata'

# Delete (replace UUID)
ssh rem 'rm /home/root/.local/share/remarkable/xochitl/<UUID>.* && systemctl restart xochitl'

Notes

Device sleeps aggressively; wake screen before SSH
EPUBs work the same way as PDFs
parent field can reference a folder UUID for organization
Changes require systemctl restart xochitl to appear in UI

2.2 KiB Raw Blame History