Tools/afar1/fieldtheory-cli

fieldtheory-cli

Sync and locally store all of your X/Twitter bookmarks. Free and open source CLI for Mac.

1.9k+5/wkemergingTypeScriptMIT Licensetrending

The Lens

Field Theory syncs your X/Twitter bookmarks to local storage and makes them actually searchable. Every bookmark gets pulled down with full metadata, stored in ~/.ft-bookmarks, and indexed for instant search. If you've bookmarked hundreds of tweets and can never find anything, this solves that.

The CLI handles the OAuth flow, syncs incrementally, and includes an AI-powered classification system that can organize bookmarks by topic. It generates a local knowledge base from your saved content. Mac-only for now, runs as a simple npm package.

Power users who treat Twitter bookmarks as a research archive get the most value. If you bookmark 5 tweets a week, you don't need this. If you bookmark 50, and half of them are technical references you need to find later, Field Theory is worth the setup.

The catch: Mac-only, Twitter API dependent (which means the API can break at any time), and the AI classification needs a Claude API key, which adds cost.

Free vs Self-Hosted vs Paid

fully free

Free Tier

Full CLI, sync, search, local storage. MIT-licensed.

Self-Hosted

Runs locally on Mac. Node.js required. Storage is local filesystem. No server component.

Paid

No paid tier. The AI classification feature requires a Claude API key ($3/MTok for Haiku), but the core sync and search work without it.

Free and open source. AI features need an API key you pay for separately.

Self-hosting ops:trivial

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Score
63/100 · B
Adoption13/30
Maintenance20/25
Community5/20
License15/15
Analysis10/10

License: MIT License

Use freely, including commercial. Just keep the license.

Commercial use: ✓ Yes

About

Owner
Andrew Farah (User)
Stars
1,942
Forks
202

Explore Further

More tools in the directory