Field Theory CLI

这个 Agent 能做什么，适合哪些场景？

Field Theory CLI 是面向 X 书签的本地优先命令行工具，同时也是 Field Theory Mac app 的命令行配套组件。它将书签缓存为 JSONL，并建立 SQLite FTS5 搜索索引，支持搜索、筛选、统计、可视化和分类。它还能把书签导出为 Markdown，生成互相链接的知识库，并通过 `ft ask` 对该知识库提问。CLI 管理 `~/.fieldtheory/library` 中的本地 Library 页面和 `~/.fieldtheory/commands` 中的可移植命令。具备 shell 权限的 Claude Code、Codex 或其他代理可通过安装 `/fieldtheory` skill 使用这些本地上下文。

运行 ft sync 时，工具从已登录 X 的受支持浏览器本地 cookie 数据库读取会话 cookie，调用 X 的内部 GraphQL API 下载书签；也可先执行 ft auth，再以 ft sync --api 通过 OAuth API 同步。它将原始数据写入 ~/.fieldtheory/bookmarks/bookmarks.jsonl，并用 bookmarks.db 中的 SQLite FTS5 索引提供 ft search <query> 的 BM25 排名搜索。ft classify 和 ft classify-domains 使用 LLM 给书签分类，ft md 导出逐条 Markdown，ft wiki 编译互链知识库，ft lint 检查或修复可修复的 wiki 问题。ft library 子命令可搜索、创建、带 SHA-256 冲突保护地更新、移入废纸篓或在 Mac app 中打开 Library 页面；ft commands 可创建、列出和验证可移植命令。

1. 一位重度 X 用户希望每天把新书签同步到本地，并用 `ft search` 查找过去收藏的分布式系统资料。
2. 研究人员需要把书签导出为 Markdown，并用 `ft wiki` 和 `ft ask` 将收藏内容整理为可检索知识库。
3. 使用 Claude Code 或 Codex 的开发者希望代理在处理任务时检索自己的书签和本地 Field Theory Library。
4. Field Theory Mac app 用户需要从终端创建或更新 Library 页面，并通过 `ft library open` 在打包版应用中打开它们。
5. 维护多个本地仓库的用户想用 `ft possible`、保存的书签种子和仓库集，生成后续工作机会的提示与后台任务。

这个 Agent 有哪些优点和局限？

如何安装或部署这个 Agent？

安装前需要 Node.js 20+。执行：
npm install -g fieldtheory

进行默认会话同步时，需要 Chrome 系、Firefox 等受支持浏览器且其中已登录 X；首次可运行：
ft sync

若使用跨平台 OAuth 同步，先运行 ft auth，然后运行：
ft sync --api

如何使用这个 Agent？

先同步并搜索：
ft sync
ft search "distributed systems"

可查看概览：
ft viz
ft categories
ft stats

导出并构建知识库：
ft md
ft wiki
ft ask "你的问题"

若要让 Claude Code 或 Codex 使用本地书签上下文，运行：
ft skill install

这个 Agent 与同类方案有什么区别？

常见问题