blackhaj

read-it-later

Sends markdown (rendered to HTML) or URLs to Readwise Reader for later reading. Use when an agent needs to save summaries, notes, or links to Readwise Reader.

blackhaj 0 Updated 4mo ago

Resources

1
GitHub

Install

npx skillscat add blackhaj/dotfiles/read-it-later

Install via the SkillsCat registry.

SKILL.md

Read It Later (Readwise Reader)

Send markdown or URLs to Readwise Reader using Bun scripts.

Setup

  1. Ensure Bun v1.3.8+ is installed.
  2. Set the Readwise token in your shell profile:
    export READWISE_ACCESS_TOKEN="your-token"

Send Markdown

Convert markdown to HTML with Bun's markdown parser and send it to Readwise Reader.

{baseDir}/scripts/send-markdown.ts "# Project Summary\n\nThis is a summary." --title "Project Summary"

To avoid shell escaping, stream markdown via stdin:

cat summary.md | {baseDir}/scripts/send-markdown.ts --stdin --title "Project Summary"

Send a URL

Use the Readwise wrapper directly to send a URL:

{baseDir}/scripts/readwise.ts url https://example.com/article --title "Example Article"

Send Raw HTML

cat article.html | {baseDir}/scripts/readwise.ts html --stdin --title "Article"

Notes

  • Both scripts accept --source <source> to set the Readwise source field.
  • Use --url <url> to supply a canonical URL for HTML/markdown saves (otherwise a placeholder URL is generated).
  • Errors are printed with response details if the Readwise API rejects the request.