Sync and store locally all of your X / Twitter bookmarks.
npm install -g fieldtheory
An open source, free CLI tool for collecting and categorizing your personal X/Twitter bookmarks. Makes your bookmarks locally available to Claude Code, Codex, or any other agent with shell access.
"What have I bookmarked about cancer research in the last three years and how has it progressed?"
"I bookmarked a number of new open source AI memory tools. Pick the best one and figure out how to incorporate it in this repo."
"Every day please sync any new X bookmarks using the Field Theory CLI."
"What do my bookmarks say about what I actually care about vs what I think I care about?"
"Find two bookmarks from different years that are about the same thing but I probably didn't realize it."
I have nothing but respect for the X team and would love proper API access to all bookmarks. However, at the time of this publishing, the API limits retrieval to just 99.
It wasn't until after this project that I realized I have bookmarked 6,577 posts since joining Twitter / X in 2008. This project stores personal bookmarks locally and makes them easy to give to an agent to interact with.
What I found in my own list was a rich library of research, ideas, projects, health studies, scientific papers, essays, books, etc that I had saved over 18 years all with the intention of some day using them. How naive.
Having finally had a chance to give this data to an agent, I felt an unexpected sense of relief and enthusiasm. A human curated list of bookmarks is an n of 1 dataset. It's peak human context. It should be observable and interactive because well just because. And (at least for me) until this project, bookmarks were inert, uncategorized, unsearchable, and largely ignored.
The project was made and intended for personal use. It is open source and free. I hope you find some use for it.
Made with 🤍 by @andrewfarah