RSS Digest

feed

brew install odysseus0/tap/feed

Workflow

1. Scan —

   feed get entries --limit 50

   for recent unread (title, feed, date, URL, summary). Auto-fetches if stale. If 0 results, run

   feed get stats

   — if 0 feeds, import starter set:

   feed import https://github.com/odysseus0/feed/raw/main/hn-popular-blogs-2025.opml

   and retry.
2. Triage — Pick 5-10 high-signal posts based on the user's prompt. If no specific interest given, prioritize surprising, contrarian, or unusually insightful pieces.
3. Read + Synthesize — For each picked entry, fetch the URL and summarize in 2-3 sentences. Parallelize when possible.
4. Present — Compile the summaries into a digest. Group by theme if natural clusters emerge.

Commands

feed get entries --limit N              # list unread entries (table)
feed get entries --feed <id> --limit N  # filter by feed
feed fetch                              # pull latest from all feeds
feed search "<query>"                   # full-text search
feed update entries --read <id> ...     # batch mark read
feed get feeds                          # list feeds with unread counts
feed get stats                          # database stats

Notes

• The entries table includes full URLs — use these to fetch articles directly. Do NOT use

  feed get entry

  for reading; fetch the URL instead.
• Do NOT mark entries as read. The user decides what to mark read.
• Default output is table — most token-efficient for scanning. Avoid

  -o json

  .
• Filter by feed if too many entries:

  --feed <feed_id>

  .