Agent skill · software engineering · aradotso
fieldtheory-cli-bookmarks
Sync, search, classify, and query X/Twitter bookmarks locally using the Field Theory CLI
Why this skill is useful
Adds specific commands for syncing and classifying X/Twitter bookmarks that the AI wouldn't reliably generate on its own.
What it needs
Requires fieldtheory, node.js installed locally. About 5k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Field Theory CLI — X/Twitter Bookmark Manager Skill by ara.so — Daily 2026 Skills collection. Field Theory CLI (ft) syncs all your X/Twitter bookmarks locally, indexes them for full-text search, classifies them by category and domain, and exposes them to AI agents via shell commands. No official API required for the default sync mode. Installation Requirements: Node.js 20+ Google Chrome (logged into X/Twitter) for default sync mode macOS for Chrome session sync; Linux/Windows use OAuth mode Verify installation: Quick Start Data is stored at ~/.ft-bookmarks/ by default. Core Commands Syncing Searching Classification Exploration & Stats Media OAuth Setup (Cross-Platform / API Mode) OAuth token stored at ~/.ft-bookmarks/oauth-token.json with chmod 600. Configuration Custom Data Directory Data File Layout Scheduling Sync Add to crontab (crontab -e): Categories Reference Category Description ---------- ------------- tool GitHub repos, CLI tools, npm packages, open-source security CVEs, vulnerabilities, exploits, supply chain technique Tutorials, demos, code patterns, how-to threads launch Product launches, announcements, "just shipped" research ArXiv papers, studies, academic findings opinion Takes, analysis, commentary, threads commerce Products, shopping, physical goods Working with Bookmark Data (TypeScript/Node.js) The bookmarks.jsonl file can be consumed directly in scripts: Query SQLite Index Directly Shell Integration in Agent Scripts Agent Integration Patterns Tell your AI agent to use ft directly in natural language: Claude Code example prompt: Troubleshooting Chrome session not found Sync stalls or returns 0 bookmarks Search returns no results Classification not running Reset all data Custom data directory issues Security Notes All data is local only — no telemetry or external calls except to X during sync Chrome cookies are read temporarily for sync and never stored separately OAuth token is stored chmod 600 — treat it like a password Default sync uses X's int …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/fieldtheory-cli-bookmarks