juliensagot

juliensagot / swift-fieldtheory-cli

Public

Pure Swift CLI to sync, search, and classify your X/Twitter bookmarks locally. Uses Safari session cookies, SQLite FTS5 for full-text search, and concurrent media downloads. Zero-config, single dependency, macOS native.

10
0
100% credibility
Found Apr 09, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A macOS command-line tool that syncs, searches, classifies, and downloads media from your X/Twitter bookmarks using Safari browser data, storing everything locally.

How It Works

1
📰 Discover bookmark saver

You hear about a handy Mac tool that backs up your Twitter bookmarks so you can search them anytime without the website.

2
💻 Set up on your Mac

Download the tool and get it running with a quick setup, just like installing any app.

3
🦘 Sign in via Safari

Log into X/Twitter in your Safari browser to prepare your session.

4
🔓 Grant file access

Allow your terminal to safely read browser info with one-time permission.

5
📥 Sync your bookmarks

Pull all your saved posts into a private local collection with one command – it feels magical as they download.

6
🔍 Search instantly

Find any bookmark by words, people, dates, or topics in seconds, right from your terminal.

7
🖼️ Save pictures & videos

Download images and clips from your bookmarks to keep everything offline.

🎉 Own your archive

Relax knowing your Twitter history is fully searchable, classified, and safe on your computer forever.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is swift-fieldtheory-cli?

This pure Swift CLI pulls your X/Twitter bookmarks into a local SQLite database using Safari session cookies—no API keys needed. Run `ft sync` to fetch them, `ft search` for full-text queries with BM25 ranking, `ft classify` to tag them by category (tools, security, research), and `ft fetch-media` for concurrent image/video downloads. It's macOS-native, zero-config, with one dependency, keeping everything offline like github pure bash bible or pure zsh github.

Why is it gaining traction?

Unlike Node.js alternatives needing Chrome Keychain or WASM SQLite, this compiles to a lean native binary—faster syncs, no runtime bloat. Developers dig the regex-based classification spotting github repos or arxiv papers, plus stats on authors/domains. Local FTS5 search beats browser bookmarks, with media in `~/.ft-bookmarks/media/`.

Who should use this?

macOS devs hoarding tweet bookmarks on SwiftUI tools, security CVEs, or github pure data projects—sync once, query offline. Perfect for those classifying feeds into "launch" or "technique" buckets before feeding to LLMs, or tracking pure storage trends without X's rate limits.

Verdict

Grab it if you're on macOS 15+ and Swift 6.1—solid tests, clean README, but 10 stars and 1.0% credibility mean it's early; watch for OAuth. Pure Swift genius for bookmark power users. (187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.