Fieldtheory Cli Bookmarks

This turns your X bookmarks into a queryable local database using the Field Theory CLI. It syncs via Chrome session (or OAuth), indexes everything with SQLite FTS5, and lets you search, filter by category or domain, and even auto-classify tweets using an LLM. The real utility is feeding bookmark context to Claude Code agents without manually digging through Twitter. You can schedule daily syncs with cron, search for "distributed systems" or "immunotherapy" from the command line, and query the SQLite DB or JSONL directly in scripts. It's built for people who bookmark hundreds of technical threads and actually want to use them later instead of letting them rot in an unfiltered pile.

skills.sh installs: 582
GitHub stars: 61
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add aradotso/trending-skills --skill fieldtheory-cli-bookmarks --agent claude-code

Installs into .claude/skills of the current project.

Files

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

npm install -g fieldtheory

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:

ft --version
ft status

Quick Start

# Sync bookmarks (reads Chrome session automatically)
ft sync

# Search immediately
ft search "machine learning"

# Explore with terminal dashboard
ft viz

Data is stored at ~/.ft-bookmarks/ by default.

Core Commands

Syncing

# Incremental sync (new bookmarks only)
ft sync

# Sync then auto-classify with LLM
ft sync --classify

# Full history crawl from the beginning
ft sync --full

# Sync via OAuth API (cross-platform, no Chrome needed)
ft sync --api

# Show sync status
ft status