Skip to content

0.4.0

Latest

Choose a tag to compare

@toniher toniher released this 31 Oct 18:07

Behavior change

  • A plain sync now also syncs your reading history: every post you opened on Substack, saved or not. Run sync --no-history to sync only saved posts and notes, as before. Each plain sync prints a note about this.

New

  • Reading history sync from Substack's inbox History tab. Each viewed post gets a seen_at timestamp and its reading progress. Posts you viewed but never saved are stored as unsaved, so default list and search results still show only saved posts.
  • list --history and search --history (MCP: history=True) browse and search what you've read, newest view first.
  • sync --only history and a new sync_reading_history MCP tool.
  • The history sync never saves, unsaves, or restores a post. Only the saved-posts sync changes saved state.

Notes

  • History sync fetches the 2,000 most recent viewed posts. If yours is longer, sync reports partial and says older history wasn't synced.
  • Substack doesn't return history strictly ordered by view time, so an incremental sync can miss some views. Run sync --force occasionally to catch them.

🤖 Generated with Claude Code