Build · rw-projects

Twitter Bookmarks Extension

Overview
Current Owner
@rasul
Stage
Build
Time in Stage
30d
Slack Channel
Stage Timeline
Backlog
2026-03-03 · @rasul
Shape
2026-03-03 · @tristan
Build
2026-03-17 · @rasul
Expedite
Ship
Learn
Done
Stage Documents
motivation.md Motivation

Twitter Bookmarks Extension — Motivation

Twitter/X bookmarks are one of Readwise's most popular integrations, but the Twitter API has become prohibitively expensive ($5K/month) and unreliable — hitting rate limits, token expirations, and struggling with full backfill. A browser extension that replicates X.com's own network requests eliminates API costs entirely, enables full bookmark history backfill, and removes dependency on Twitter API pricing changes.

shape.md Shape Deliverable

Twitter Bookmarks Extension — Shape

Entered Shape: 2026-03-03 · Owner: @tristan

Key Decisions

  • Move from Twitter API-based bookmark import ($5K/month, hitting rate limits) to a browser extension approach.
  • Extension uses service worker to replicate X.com's own GraphQL requests using the user's session cookies — no visible tabs, no API costs.
  • Ship as a standalone extension (not built into the existing Readwise extension), consistent with the ChatGPT Import precedent.
  • Read-only — only pulls bookmarks, never modifies anything on the user's X account.
  • Desktop-only; mobile users continue using the API and get nudged to set up the extension on desktop for full backfill.
  • After initial backfill completes, disable API-based import for that user to avoid duplicates.

Scope

  • Chrome extension that fetches bookmarks via background service worker.
  • Initial full backfill + ongoing periodic sync via Chrome alarms.
  • Backend endpoint to receive extension data (PR #8565).
  • Settings page: last sync time, manual sync trigger, revoke access.
  • Chrome Web Store listing.

Appetite

Small — single engineer (Rasul), with Tristan's spec. Ibai contributed related Twitter articles work.

build.md Build Deliverable

Twitter Bookmarks Extension — Build (WIP)

This document is underway while the project is in Build. It will be finalized when the stage completes.

Entered Build: 2026-03-17 · Owner: @rasul · Initiative: rw-projects

Goal

Ship a Chrome extension that reliably syncs Twitter/X bookmarks to Readwise and Reader.

What's been done

  • Chrome extension built and submitted to Chrome Web Store for review.
  • Extension approved for internal (staff-only) testing.
  • Backend PR #8565 open for handling extension data.
  • Related work: auto-save Twitter articles to Reader (PR #8568, merged Mar 19) and X Articles via API rich_text (PR #8606, merged Mar 20).

What's in progress

  • Merging backend PR #8565 for internal testing.
  • Internal team testing of the extension.
  • Chrome Web Store listing updates (logo, description, screenshots).

What's not done yet

  • Broader user rollout.
  • Public Chrome Web Store listing.

Open Questions (for next stage)

  • Testing coverage — who else on the team will test beyond Rasul?
  • Any edge cases with different Twitter account configurations?
Daily Digests 5
2026-04-13 Daily Digest

Twitter Bookmarks Extension — 2026-04-13

Stage: Build | Owner: @rasul

Activity

  • Rasul reported extension has been approved for internal testing on Chrome Web Store.
  • Backend PR #8565 still open — Rasul wants to merge for staff-only testing.
  • Plan: merge PR, internal testing, update extension listing, then ship to users this week.

Key decisions

  • Staff-only testing before broader rollout.
2026-04-12 Daily Digest

Twitter Bookmarks Extension — 2026-04-12

Stage: Build | Owner: @rasul

Activity

  • Tristan created dedicated #rp-twitter-bookmarks-extension channel.
  • Asked Rasul for latest status update.
2026-03-19 Daily Digest

Twitter Bookmarks Extension — 2026-03-19

Stage: Build | Owner: @rasul

Activity

  • Tristan wrote the shaping spec ("X/Twitter Bookmarks Import via Browser Extension") in Notion, covering product strategy, flows, mobile strategy, and technical notes.
  • Spec hacked up quickly with Claude's help.

Key decisions

  • Standalone extension (not built into existing Readwise extension).
  • Desktop-only; mobile users continue API-based import with nudge to set up extension.
  • After backfill completes, disable API import for that user to prevent duplicates.
2026-03-17 Daily Digest

Twitter Bookmarks Extension — 2026-03-17

Stage: Build | Owner: @rasul

Activity

  • Rasul opened revised PR #8565 ("[Twitter] Bookmarking Pulling Extension") with a Loom demo.
  • Ibai opened PR #8568 to auto-save Twitter articles to Reader (merged Mar 19).
  • Extension submitted to Chrome Web Store for review before Rasul's PTO.
  • Ibai also opened PR #8606 to save X Articles directly via API rich_text markdown (merged Mar 20).
2026-03-03 Daily Digest

Twitter Bookmarks Extension — 2026-03-03

Stage: Shape | Owner: @rasul

Activity

  • Rasul opened initial PR #8364 ("Add X bookmarks browser-extension") to add a Chrome extension for syncing Twitter bookmarks.
  • PR was later closed in favor of a revised approach.
DateSummary
2026-04-13 Extension approved for internal testing on Chrome Web Store. Rasul plans to merge PR and ship to users this week.
2026-04-12 Dedicated #rp-twitter-bookmarks-extension channel created. Rasul asked to provide status.
2026-03-19 Tristan wrote Notion shaping spec — product strategy, flows, technical notes.
2026-03-17 New extension PR #8565 opened with Loom demo. Related Twitter articles PRs from Ibai.
2026-03-03 Initial Chrome extension PR opened (#8364), later closed for revised approach.
Linked Documents & Assets