Skip to content

reading-weekly — new long-form X articles become reference notes

Weekly, fetch new articles from followed X authors, summarise each into a reference note with lessons and a "Where EmbeddedEra stands" checklist, send one ntfy with the single best idea.

Input → Movement → Output

Reads ~/.config/reading-authors (one handle per line; initially N01ennn), the free fxtwitter mirror, and URLs in ~/Notes/reference/inbox.md (one per line, removed once done). Summarises with api-credits run backlog -- claude -p --tools "" (monthly API credits; skipped if the share is used up). Writes notes, appends the README index, runs notes-sync, sends ntfy (no click URL: the notebook does not publish /reference).

Why this shape

The mirror's timeline endpoint is unreliable (404 now and then). A failure is "skip, retry next week", never "no new articles"; it alerts at most once per 28 days, and the backfill (up to 15 older articles) repeats until one pass completes cleanly. Dedupe: any status id found in any reference/*.md or in state counts as processed. Claims stay attributed to the author.

Steps

  1. ~/.local/bin/reading-weekly (state ~/.local/state/reading/state.json; heartbeat limit reading-weekly = 192 in ~/.config/cron-watch.conf).
  2. Test: python3 ~/.local/bin/test_reading_weekly.py.

If you change this

  • Hits: ~/Notes/reference/ index, API credits backlog share, cron-watch.conf.
  • Does not hit: the store, ERP, any publishing.

See