A CLI tool that filters your X (Twitter) timeline using Claude AI, surfacing content that matches your interests while filtering out noise.

# Install with pipx (recommended)
pipx install git+https://github.com/ericksoa/xfeed.git
# Or with pip
pip install git+https://github.com/ericksoa/xfeed.git
# Run it
xfeed mosaic

On first run, xfeed will:

1. Prompt for your Anthropic API key
2. Auto-install the browser component
3. Create a default objectives file at ~/.xfeed/objectives.md

Prerequisite: You must be logged into X (twitter.com) in Chrome.

• AI-Powered Filtering: Claude Haiku scores tweets 0-10 based on your interests
• Rich Mosaic Display: Visual heatmap sized by relevance
• Reasoning Quality: Boosts evidence-based posts, penalizes rage bait
• Interactive Controls: Adjust filters on-the-fly
• Engagement Tracking: See your notifications at a glance

xfeed mosaic

Keyboard shortcuts:

xfeed fetch # List view of filtered tweets
xfeed watch # Periodic updates (ambient mode)
xfeed ticker # CNN-style rotating display
xfeed objectives --edit # Edit your interests
xfeed config --show # Show configuration

Edit ~/.xfeed/objectives.md to define what you care about:

# Things I Care About
## Topics
- AI/ML research
- Developer tools
- Open source
## People
- @karpathy
- @simonw
## Exclude
- Crypto promotions
- Rage bait
- Drama

Set via environment variable or xfeed will prompt on first run:

export ANTHROPIC_API_KEY=sk-ant-...

All config is stored in ~/.xfeed/:

• .env - API key (chmod 600)
• config.yaml - Settings
• objectives.md - Your interests

MIT