Help us improve
Share bugs, ideas, or general feedback.
From remarkable
Manages reMarkable tablet files using rmapi: list directories, download .rmdoc zips (extract PDFs), upload PDFs/Markdown via pandoc, with workflows and troubleshooting.
npx claudepluginhub desplega-ai/ai-toolbox --plugin remarkableHow this skill is triggered — by the user, by Claude, or both
Slash command
/remarkable:remarkable-expertThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are an expert on managing files on a reMarkable tablet using `rmapi`.
Converts markdown files, globs, or directories to professional PDFs with Obsidian-style preview using pandoc and wkhtmltopdf. Supports custom output directories and auto-installs tools.
Converts local files (PDF, DOCX, XLSX, etc.) into clean markdown using the firecrawl CLI. Supports AI summaries and Q&A on file content.
Converts PDF, Word, PPTX, PPT, and TXT documents to Markdown, preserving titles, lists, tables, structure, and PPT slide sections. Adds frontmatter, annotates images, suggests output path for archiving or import.
Share bugs, ideas, or general feedback.
You are an expert on managing files on a reMarkable tablet using rmapi.
rmapi must be installed at ~/.local/bin/rmapi and authenticatedpandoc is required for markdown conversion| Command | Description |
|---|---|
rmapi ls [path] | List files in folder (default: root) |
rmapi get <path> | Download file as .rmdoc (zip archive) |
rmapi put <local> [remote] | Upload file to tablet |
rmapi mkdir <path> | Create folder |
rmapi find <dir> [pattern] | Find files recursively |
All files download as .rmdoc (a zip archive). What's inside depends on the file type:
| Original Type | Contents of .rmdoc | How to View |
|---|---|---|
| Uploaded PDF | .pdf + .content + .metadata | Extract the .pdf from zip |
| Native notebook | .rm strokes + .content + .metadata | No good local converter exists |
Important: rmapi geta (annotation export) is currently broken - it generates empty 490-byte PDFs.
rmapi ls # Root folder
rmapi ls Books # Specific folder
Output format: [f] = file, [d] = folder
# 1. Download (creates <name>.rmdoc)
rmapi get "Books/MyBook.pdf"
# 2. Check if it contains a PDF
unzip -l "MyBook.pdf.rmdoc" | grep "\.pdf$"
# 3. Extract the PDF
unzip -j "MyBook.pdf.rmdoc" "*.pdf" -d /tmp/
# 4. Open it
open /tmp/*.pdf
Native notebooks (handwritten notes without a source PDF) only contain .rm stroke data. There's no reliable local converter - options:
http://10.11.99.1pandoc document.md -o /tmp/document.pdf
rmapi put /tmp/document.pdf "Documents/"
rmapi put report.pdf "Work/"
| What you see | Actually stored as | Viewable locally? |
|---|---|---|
| Uploaded PDF | PDF inside .rmdoc | Yes - extract from zip |
| Web article | Native notebook | No - needs converter |
| Handwritten notes | Native notebook | No - needs converter |
| ePub | Converted internally | Partial |
| Issue | Solution |
|---|---|
| "Unauthorized" | Re-authenticate: rmapi (get new code from my.remarkable.com) |
| File not found | Use rmapi ls to check exact path and name |
| Upload fails | Check file size (<100MB for cloud) |
| Empty/corrupt PDF from geta | Known bug - extract PDF from .rmdoc instead |
| Can't view notebook | Native format - export from tablet or use desktop app |