RebundleRebundle Stack
Claude Code Hub

Readwise Reader CLI

Conecta Readwise Reader a Claude Code

Pega un prompt. Claude te pregunta qué quieres hacer con tu biblioteca, instala el CLI oficial de Readwise y te guía paso a paso para iniciar sesión.

Necesitas una cuenta de Readwise con suscripción activa (Reader va incluido). El CLI usa la API oficial. Claude empieza en modo solo lectura y nunca te pedirá que pegues tu token en el chat.
1

Abre Claude Code

Tú haces esto
  1. 1Abre Claude Desktop
  2. 2Haz clic en la pestaña Claude Code
  3. 3Elige cualquier carpeta para trabajar
2

Pega este prompt

Claude Code

Claude te hará unas preguntas, revisará tu ordenador, instalará el CLI y te dirá exactamente cómo iniciar sesión. Solo tienes que seguirle.

dile esto a claude
Quiero conectar Readwise Reader a Claude Code para que puedas leer, buscar y organizar lo que guardo en Reader (artículos, PDFs, newsletters y highlights). No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir. CONTEXTO PARA TI - Se usa el CLI oficial de Readwise, que va por la API oficial. Requiere una suscripción activa de Readwise (Reader incluido); la API no tiene plan gratis. - Instalación: requiere Node.js. Se instala con "npm install -g @readwise/cli" y se comprueba con "readwise --version". - Token: es un token de cuenta que se copia en readwise.io/access_token y no caduca salvo que se revoque. El login es "readwise login-with-token <token>", sin navegador, y la auth queda cacheada, así que solo se hace una vez. - Verificación: "readwise reader-list-documents --location new --limit 1" debe devolver 1 documento. - Comandos: los reader- actúan sobre los documentos de Reader y los readwise- sobre los highlights. Añade --json para salida legible por ti y --help para ver todas las opciones de un comando. - Lectura: reader-list-documents, reader-search-documents (búsqueda semántica), reader-get-document-details (contenido en Markdown), reader-export-documents, readwise-list-highlights, readwise-search-highlights, reader-get-document-highlights, readwise-get-daily-review. - Escritura: reader-create-document, reader-move-documents, reader-create-highlight. - Ubicaciones de Reader: new (inbox), later, shortlist, archive, feed. No hay una ubicación "leído": usa el campo reading_progress para saber qué terminé de verdad. - Límites: rate limit del orden de 20 peticiones por minuto en list y get; el CLI cachea y --refresh fuerza a volver a pedir. Los highlights vienen planos y del más nuevo al más viejo, así que un documento muy resaltado inunda la lista. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: si ya tengo cuenta de Readwise con suscripción, y qué quiero conseguir (buscar en lo que guardo, resumir artículos, trabajar con mis highlights, u organizar la biblioteca). 2. REVISAR: comprueba tú mismo lo que puedas: qué sistema operativo uso, si hay Node.js y npm y qué versión, y si el comando readwise ya está instalado. Si falta Node.js, explícame cómo instalarlo en mi sistema. Instala lo que falte pidiéndome permiso antes. 3. GUIARME CON EL TOKEN: dime que abra readwise.io/access_token y copie mi token. Nunca me pidas que te lo escriba en el chat; basta con que lo copie. Cuando te diga «OK», haz tú el login leyendo el token del portapapeles: readwise login-with-token "$(pbpaste)" en Mac, o readwise login-with-token (Get-Clipboard) en PowerShell en Windows. No lo muestres, repitas ni escribas en el chat, y después vacía el portapapeles. 4. PROBAR: ejecuta la verificación de solo lectura (reader-list-documents con --location new y un --limit pequeño, por ejemplo 5) y enséñame los títulos para confirmar que funciona. 5. RECORDAR: crea una skill personal con cómo está instalado, los comandos útiles, los límites y la regla de que es solo lectura. Así la próxima vez me basta con preguntarte. Reglas: por defecto solo lectura. Nada de guardar, mover, archivar, resaltar ni etiquetar documentos salvo que yo lo pida de forma explícita, y en ese caso dime antes qué vas a cambiar y espera mi confirmación. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo. CÓMO TRABAJAR CONMIGO - Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano. - Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción. - Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo. - Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado. - Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones. - Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill. - La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill. - Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle): hooks: Stop: - hooks: - type: command once: true command: | grep -q '"stop_hook_active":true' && exit 0 echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'

Después, prueba con estos

Cuando Claude confirme que está conectado, pídele cosas como:

Enséñame los últimos 10 artículos que guardé en Reader

Busca en mi biblioteca todo lo que tengo sobre 'spaced repetition'

Resume el documento que más he resaltado este mes

Archiva los artículos de mi inbox que ya leí al 100%

El CLI en detalle

Lo que el prompt monta por ti, para quien prefiera hacerlo a mano.

Setup

Instala en 3 pasos

1

Instala el CLI

Requiere Node.js. Una instalación global deja el comando readwise en tu PATH.

npm install -g @readwise/cli
readwise --version
2

Copia tu token de acceso

Un token de cuenta (no caduca salvo que lo revoques). Cópialo desde los ajustes de Readwise.

readwise.io/access_token
3

Inicia sesión y verifica

El login por token es headless (sin navegador), ideal para scripts y cron. La auth queda cacheada, así que solo lo haces una vez.

readwise login-with-token <token>
# verifica: debe devolver 1 documento
readwise reader-list-documents --location new --limit 1

Reference

Qué puedes ejecutar

Los comandos con prefijo reader- actúan sobre tus documentos de Reader; los readwise- sobre tus highlights. Añade --json a cualquier comando para salida legible por agentes, y --help para ver todas sus opciones.

Reader · documentos
ComandoQué hace
reader-list-documentsLista documentos por ubicación (new, later, shortlist, archive, feed), con filtros y selección de campos.
reader-search-documentsBúsqueda semántica sobre todo lo guardado, opcionalmente por categoría, autor o fecha.
reader-get-document-detailsTrae el contenido completo de un documento en Markdown, listo para resumir o citar.
reader-create-documentGuarda una URL (Reader la scrapea) o Markdown en crudo, con título, tags y notas.
reader-move-documentsMueve documentos entre ubicaciones: archiva lo leído, manda cosas a later.
reader-export-documentsExporta toda la biblioteca (o un delta desde una fecha) como ZIP de ficheros Markdown.
Readwise · highlights
ComandoQué hace
readwise-list-highlightsLista tus highlights más recientes, o filtra por libro o fecha.
readwise-search-highlightsBúsqueda semántica y full-text sobre cada highlight que has hecho.
reader-get-document-highlightsTrae todos los highlights de un documento concreto de Reader.
reader-create-highlightResalta un pasaje con una nota y tags opcionales.
readwise-get-daily-reviewTrae el repaso diario (repetición espaciada) de highlights pasados.

Ubicaciones de Reader: new (inbox), later, shortlist, archive, feed.

Capacidades

  • Búsqueda semántica sobre toda tu biblioteca: cada palabra de cada artículo, PDF y newsletter está indexada.
  • Lee y escribe: guardar, resaltar, etiquetar, mover y exportar, no solo consultar.
  • Lista para agentes: salida --json en cada comando y --help para todas las opciones.
  • Headless: el login por token funciona en scripts y cron, sin navegador.

Limitaciones

  • Requiere una suscripción activa de Readwise (Reader incluido); no hay plan gratis para la API.
  • Tiene rate limit (del orden de 20 peticiones/minuto en list y get); el CLI cachea, usa --refresh para forzar.
  • Los highlights vienen planos y newest-first, así que un documento muy resaltado inunda la lista.
  • No hay una ubicación "leído": usa el campo reading_progress para saber qué terminaste de verdad.

Rebundle · 2026