Grokmarks

AI bookmark manager for X: auto-classifies tweets into topics, shows live trending feeds, lets you chat with Grok about your content, and generates audio summaries you can listen to.

Comment

Inspiration

I've been an avid X (Twitter) user for years, and my bookmarks have become a graveyard of valuable content I'll never find again. With hundreds of saved tweets across topics like AI, startups, and tech news, I realized there was no good way to organize, revisit, or make sense of them. I wanted a tool that could automatically categorize my bookmarks and let me consume them in new ways, like listening to summaries while commuting.

What it does

Grokmarks is an AI-powered bookmark manager for X that:

  • Auto-classifies your bookmarked tweets into topics using Grok 4.1
  • Shows live trending posts related to each topic from X's real-time feed
  • Enables chat with Grok to ask questions about your saved content
  • Generates audio overviews using xAI's Voice API, turning your bookmarks into podcast-style summaries with synchronized tweet highlighting
  • Allows custom addition of tweets and topics Users can add tweets to existing topics or an entirely new topic of their own. This makes the idea go beyond just a bookmark manager

How I built it

  • Frontend: React + TypeScript + Vite
  • Backend: Node.js + Express + TypeScript
  • Database: SQLite with better-sqlite3
  • AI: Grok 4.1 (grok-4-1-fast-non-reasoning) for classification, chat, and content analysis
  • Audio: xAI Voice API for text-to-speech with timeline generation for tweet sync
  • Auth: X OAuth 2.0 for secure bookmark access

Challenges I faced

  • Topic classification accuracy required iterating on prompts and adding label normalization to avoid duplicate/similar topics
  • Audio sync was harder than expected—getting tweets to highlight at the right moment during playback required building a custom timeline system
  • OAuth flow with X had some quirks around token refresh and PKCE

What I learned

  • How to work with xAI's Grok API and Voice API for real-time TTS
  • Building streaming audio with synchronized UI updates
  • The importance of good prompt engineering for consistent AI outputs
  • X API authentication and data fetching patterns

What's next

  • Browser extension to bookmark directly from X
  • Mobile app for on-the-go listening
  • Collaborative topics/sharing with friends
  • Smarter recommendations based on bookmark patterns

Built With

Share this project:

Updates