# fieldtheory-cli-bookmarks

Use Field Theory CLI through an agent to sync, search, and classify X/Twitter bookmarks. Handy when you want to query saved posts without leaving your coding workflow.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 627 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/fieldtheory-cli-bookmarks/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/fieldtheory-cli-bookmarks

## What it does

The skill gives an agent access to `ft` commands for updating a local bookmark collection, searching post text, filtering by author or category, and opening individual entries. Classification can use an LLM or regex rules. By default, the CLI keeps its files in `~/.ft-bookmarks/`; set `FT_DATA_DIR` to use another location.

The CLI requires Node.js 20+. Chrome-based sync also needs Google Chrome signed in to X/Twitter, and that mode is listed for macOS. Linux and Windows use OAuth instead. Install the CLI with `npm install -g fieldtheory`, then run `ft sync`. OAuth setup uses `ft auth` followed by `ft sync --api`; LLM-based classification requires access to an LLM.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/fieldtheory-cli-bookmarks/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/fieldtheory-cli-bookmarks/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/fieldtheory-cli-bookmarks/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/fieldtheory-cli-bookmarks/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills fieldtheory-cli-bookmarks
```

2. **Manually: put the files in place**
- File: `.github/skills/fieldtheory-cli-bookmarks/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/fieldtheory-cli-bookmarks
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/fieldtheory-cli-bookmarks/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill fieldtheory-cli-bookmarks -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/fieldtheory-cli-bookmarks/SKILL.md

## When to use it
- sync new X/Twitter bookmarks to local storage
- search saved posts by topic or text
- filter bookmarks by author, category, or date
- classify saved posts with an LLM or regex
- inspect bookmark counts by topic and author

## Example prompts
- Sync my new X bookmarks and find posts about Rust.
- Search my bookmarks for distributed systems and summarize the results.
- List my research bookmarks from 2025.

## Similar
- [x-bookmark-quote-posts](https://affpapa.org/en/nevibecode/skills/x-bookmark-quote-posts.md) — skill · 1300 installs
- [cubox](https://affpapa.org/en/nevibecode/skills/cubox.md) — skill · 1100 installs
- [xurl](https://affpapa.org/en/nevibecode/skills/xdevplatform-xurl.md) — skill · 660 installs
- [twitter-cli](https://affpapa.org/en/nevibecode/skills/twitter-cli.md) — skill · 594 installs
- [twitter-automation](https://affpapa.org/en/nevibecode/skills/twitter-automation.md) — skill · 870600 installs
- [raindrop-api](https://affpapa.org/en/nevibecode/skills/raindrop-api.md) — skill · 503 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 186 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md