fieldtheory-cli
Field Theory CLI for bookmarks, Library, commands, and agent workflows
fieldtheory-cli is a command-line tool and agent skill that syncs X (Twitter) bookmarks locally, manages a personal knowledge base, and exposes searchable bookmark context to AI agents through shell integration. It works as both a standalone CLI for organizing thousands of bookmarks with full-text search, LLM-powered classification, and markdown export, and as an installable skill for Claude Code and Codex that lets agents search and reason over your curated bookmarks. Designed primarily for macOS, it also supports Linux and Windows with session-based or OAuth sync.
Key Features
Use Cases
- 01Give Claude Code automatic access to your curated X bookmarks when building features or researching libraries
- 02Sync and classify thousands of bookmarks daily, then search by topic, author, or domain with full-text queries
- 03Build a personal knowledge base from bookmarks with markdown export and wiki-style interlinking for RAG
- 04Schedule nightly AI agent runs that analyze recent bookmarks and generate project roadmaps or research summaries
- 05Ask questions against your bookmark knowledge base with LLM-powered Q&A and save answers as concept pages
- 06Integrate your curated bookmarks into agent workflows for research, tool discovery, and domain-specific context retrieval
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
fieldtheory-cli — FAQ
What is fieldtheory-cli and what does it do?+
fieldtheory-cli is a command-line tool that syncs your X bookmarks locally, provides full-text search and LLM classification, and installs a `/fieldtheory` skill for Claude Code and Codex so agents can search your bookmarks. It stores all data locally under `~/.fieldtheory/` with no cloud sync or telemetry.
How do I install the fieldtheory agent skill for Claude Code?+
Install the CLI globally with `npm install -g fieldtheory`, then run `ft skill install` to automatically add the `/fieldtheory` skill to Claude Code and Codex. The skill enables agents to search and reason over your bookmarks when relevant.
Which AI clients and agents work with fieldtheory-cli?+
The `/fieldtheory` skill works with Claude Code and Codex. Any agent with shell access can also invoke `ft` CLI commands directly to search bookmarks, export markdown, or run workflows.
Do I need API keys or credentials to sync bookmarks?+
No API keys are required for the default browser session sync—it extracts cookies from Chrome, Firefox, Brave, or Edge while you're logged into X. Alternatively, use `ft auth` to set up OAuth for cross-platform API sync.
Is fieldtheory-cli free and open source?+
Yes, fieldtheory-cli is released under the MIT license and is completely free. The companion Field Theory Mac app is open-source under AGPL-3.0-or-later.
What are the prerequisites and platform requirements?+
Requires Node.js 20+ and a supported browser (Chrome, Firefox, Brave, Edge, or variants) for session sync. Works on macOS, Linux, and Windows, with best support on macOS. Windows users should use `fieldtheory` instead of `ft` in PowerShell.
How do I install fieldtheory-cli?+
Open the source repository on GitHub and follow its README. fieldtheory-cli is a skill — MCP Agents Market links you directly to the official repo.
Is fieldtheory-cli free?+
fieldtheory-cli is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.