Goal
Search your X/Twitter archive with sub-millisecond queries using xf.
What Is XF?
XF provides blazingly fast full-text search across your personal X/Twitter archive: tweets, likes, DMs, and Grok conversations. Built with Tantivy, it delivers sub-millisecond queries with hybrid BM25 and semantic search.
All indexing happens locally on your machine. No data leaves your system. Index once at ~10,000 docs/second, then search instantly across years of content.
Ultra-Fast
Sub-millisecond query times
Tantivy + SQLite
Full-text search with metadata
Date Ranges
Filter by time periods
Export
Output to JSON, CSV, or plain text
Essential Commands
Index your Twitter archive
Search your tweets
Search with date filter
Show all options
Note
Download your archive from X/Twitter settings, then run
xf index once.Example Searches
bash
# Index your archive (one-time)xf index ~/Downloads/twitter-archive# Search for a topicxf search "machine learning"# Search within a date rangexf search "rust" --from 2024-01-01 --to 2024-06-30# Export results to JSONxf search "AI" --format json > results.json