fieldtheory-cli-bookmarks — Claude Code skill: bookmark search
Use Field Theory CLI through an agent to sync, search, and classify X/Twitter bookmarks. Handy when you want to query saved posts without leaving your coding workflow.
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a claude-codeWhat fieldtheory-cli-bookmarks does
The skill gives an agent access to ft commands for updating a local bookmark collection, searching post text, filtering by author or category, and opening individual entries. Classification can use an LLM or regex rules. By default, the CLI keeps its files in ~/.ft-bookmarks/; set FT_DATA_DIR to use another location.
The CLI requires Node.js 20+. Chrome-based sync also needs Google Chrome signed in to X/Twitter, and that mode is listed for macOS. Linux and Windows use OAuth instead. Install the CLI with npm install -g fieldtheory, then run ft sync. OAuth setup uses ft auth followed by ft sync --api; LLM-based classification requires access to an LLM.
What it helps with
- sync new X/Twitter bookmarks to local storage
- search saved posts by topic or text
- filter bookmarks by author, category, or date
- classify saved posts with an LLM or regex
- inspect bookmark counts by topic and author
Example prompts for the agent
- Sync my new X bookmarks and find posts about Rust.
- Search my bookmarks for distributed systems and summarize the results.
- List my research bookmarks from 2025.
How to install fieldtheory-cli-bookmarks
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a claude-code2Manually: put the files in place
~/.claude/skills/fieldtheory-cli-bookmarks/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fieldtheory-cli-bookmarks/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a codex2Manually: put the files in place
.agents/skills/fieldtheory-cli-bookmarks/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a cursor2Manually: put the files in place
.cursor/skills/fieldtheory-cli-bookmarks/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills fieldtheory-cli-bookmarks2Manually: put the files in place
.github/skills/fieldtheory-cli-bookmarks/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/fieldtheory-cli-bookmarksManually: put the files in place
.devin/skills/fieldtheory-cli-bookmarks/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about fieldtheory-cli-bookmarks
How do I install fieldtheory-cli-bookmarks in Claude Code?
Run npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a claude-code. The skill file is located at ~/.claude/skills/fieldtheory-cli-bookmarks/SKILL.md.
What does fieldtheory-cli-bookmarks do?
It lets an agent use Field Theory CLI to sync, search, and classify X/Twitter bookmarks. You can also filter entries and inspect collection stats.
What do I need for Chrome-based bookmark sync?
You need Node.js 20+ and Google Chrome signed in to X/Twitter. This sync mode is listed for macOS; Linux and Windows can use OAuth with ft auth and ft sync --api.