| name | xf |
| description | Search X (Twitter) archives for insights, conversations, and knowledge. Use when mining tweets, DMs, Grok chats, likes, or extracting information from X data exports. |
xf Knowledge Extraction
Core Insight: Your X archive is a goldmine. Sub-millisecond search makes iterative exploration practical. Mine your history before rebuilding context.
The Goldmine Principle
Your X archive contains:
- Public thoughts — Tweets capture your evolving thinking over years
- Private conversations — DMs hold detailed discussions, decisions, links shared
- AI interactions — Grok chats show what questions you asked and answers received
- Curated content — Likes reveal what resonated with you
The insight: Mining your X history surfaces forgotten context faster than rebuilding it.
THE EXACT PROMPT — Discovery Workflow
1. Bootstrap: Check health, get archive overview
xf doctor && xf stats --format json | jq '{tweets, likes, dms, grok_messages}'
2. Search: Find content by topic (hybrid mode default = best)
xf search "KEYWORD" --format json --limit 50
3. Filter by type: Narrow to specific content
xf search "KEYWORD" --types dm --context --format json # DMs w/ conversation
xf search "KEYWORD" --types grok --format json # AI Q&A
4. Follow hits: Get full context
xf tweet <ID> --thread --format json # Tweet thread
xf search "KEYWORD" --types dm --context --format json # Full DM thread
5. Extract: Export for analysis
xf search "topic" --format json --limit 1000 | jq '[.[] | {text, date: .created_at}]'
Why This Workflow Works
- Hybrid search first — Default mode combines keyword + semantic for best coverage
--format json — Machine-readable output for piping to jq