fieldtheory-cli

Sync X/Twitter bookmarks locally and index them with SQLite FTS5.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/Aradotso/devtools-skills --skill fieldtheory-cli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fieldtheory-cli
Source: https://github.com/Aradotso/devtools-skills/tree/main/skills/fieldtheory-cli
Command: npx skills add https://github.com/Aradotso/devtools-skills --skill fieldtheory-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of losing context and wasting time when you want to find, organize, and reuse information from your X/Twitter bookmarks.

Core Features & Use Cases

  • Local-first syncing: Syncs X bookmarks into ~/.fieldtheory/bookmarks/ without needing an API key for the default flow.
  • Fast full-text search: Enables full-text search over bookmark text using SQLite FTS5 (BM25 ranking).
  • LLM-based classification: Classifies bookmarks into categories and domains so you can build theme-based collections.
  • Export and agent-ready outputs: Exports enriched markdown, builds an interlinked wiki, and supports agent integration via a dedicated /fieldtheory skill for shell-enabled tools.
  • Knowledge-building workflows: Runs “possibility” flows to derive ideas from bookmark-grounded seeds and supports an idea/library workflow.

Quick Start

Ask to sync and index your bookmarks by running the fieldtheory-cli sync command.

Frequently Asked Questions about fieldtheory-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync X Twitter bookmarks locally for offline full-text search?▼

You can sync X Twitter bookmarks locally by running the fieldtheory-cli sync command, which stores them in ~/.fieldtheory/bookmarks/ without requiring an API key for the default flow.

Can I export Twitter bookmarks to markdown for AI agent integration?▼

Yes, you can export Twitter bookmarks to enriched markdown files and build an interlinked wiki, supporting AI agent integration via a dedicated /fieldtheory skill for shell-enabled tools.

How does LLM classification work for organizing Twitter bookmarks?▼

LLM classification organizes Twitter bookmarks by automatically categorizing them into themes and domains, allowing you to build structured, searchable collections from your saved posts.

Do I need an API key to sync and index X bookmarks with SQLite FTS5?▼

No, you do not need an API key for the default local syncing flow, which indexes bookmark text for fast full-text search using SQLite FTS5 with BM25 ranking. Optional OAuth-based API syncing is available.

What is the best way to search past Twitter posts saved in my bookmarks?▼

The best way to search past Twitter posts is syncing them into a local knowledge base using fieldtheory-cli, which applies SQLite FTS5 BM25 ranking to deliver fast, full-text search results.

Can I build an interlinked wiki from my Twitter bookmarks?▼

Yes, you can build an interlinked wiki from your Twitter bookmarks by syncing them locally, applying LLM-based classification, and exporting the enriched data to markdown files.