FeynmanLM Docs

Appearance

X Posts ​

FeynmanLM lets you sign in with your X (formerly Twitter) account and sync your saved bookmarks — turning posts you've bookmarked into flashcard sources.

Setting Up X API Access ​

Reading bookmarks requires a paid X API plan. X does not include bookmark access on the free tier. You'll need to create a developer app and subscribe to a paid plan before you can use this feature.

1. Create a Developer Account ​

  1. Go to the X Developer Portal and sign in with your X account.
  2. If you don't already have a developer account, follow the prompts to apply for one.

2. Subscribe to a Paid Plan ​

  1. In the Developer Portal, go to your Dashboard.
  2. Subscribe to the Basic plan (or higher). This is the minimum tier that includes bookmark read access.
  3. X uses pay-as-you-go pricing — see developer.x.com for current rates.

Paid plan required

The free tier does not include bookmark access. If you skip this step, you'll see an "X API paid plan required" error when trying to sync.

3. Create an App ​

  1. In the Developer Portal, go to Projects & Apps and create a new app (or use an existing one).
  2. Under your app's Settings, set up User Authentication:
    • App permissions: Select Read (bookmark.read, tweet.read, users.read)
    • Type of App: Select Native App
    • Callback URL: Enter feynman-flashcards://x-callback
  3. Save your settings.
  4. Go to the Keys and Tokens tab and copy your Client ID.

TIP

You do not need your Client Secret. FeynmanLM uses OAuth 2.0 with PKCE, which is designed for native apps and doesn't require a client secret on the device.

Signing In ​

  1. Open the Studio tab and tap the X tab in the source sidebar.
  2. Tap Sign in with X. This opens an OAuth flow in your browser where you authorize FeynmanLM to read your bookmarks.
  3. After authorization, you're redirected back to the app and signed in.

Your credentials are stored securely in the system Keychain. You can sign out at any time from the same sidebar tab.

Syncing Bookmarks ​

Once signed in, tap Sync Bookmarks in the X sidebar tab. The app fetches your bookmarked posts and adds them to your source queue.

On subsequent syncs, only new bookmarks are fetched — the app tracks the most recent bookmark it has seen and stops pagination there, so syncs are fast and cost-efficient.

Each bookmarked post appears as a source with:

  • The full tweet text (including long-form note tweets)
  • Author name and handle
  • Any URLs included in the post

Generating Flashcards ​

Bookmarked posts work like any other source in Studio:

  1. Select a post from the sidebar. The full text is displayed.
  2. Click Generate Flashcards. The AI proposes cards based on the content.
  3. Review each card — accept, edit, or skip.
  4. Accepted cards are routed to the Articles deck.

Browser Extension ​

You can also capture individual tweets while browsing X in Chrome or Safari. Right-click on any tweet and choose Draft Flashcard to send it to FeynmanLM without needing to bookmark it first.

Tips ​

  • Bookmark threads and long-form note tweets for the richest flashcard proposals — short one-liner tweets rarely have enough substance for good cards.
  • Use the browser extension for one-off tweets you encounter while browsing. Use the bookmark sync for batch processing posts you've saved over time.