REPOGEO REPORT · LITE

afar1/fieldtheory-cli

Default branch main · commit 583f1b71 · scanned 5/11/2026, 11:53:41 PM

GitHub: 1,707 stars · 188 forks

AI VISIBILITY SCORE

35 /100

Critical

Category recall

0 / 2

Not recommended in any query

Rule findings

1 pass · 1 warn · 0 fail

Objective metadata checks

AI knows your name

3 / 3

Direct prompts that named your repo

HOW TO READ THIS REPORT

Action plan is what to do next — copy-pasteable changes prioritized by impact. Category visibility is the real GEO test: when a user asks an AI a brand-free question that should surface afar1/fieldtheory-cli, does the AI actually recommend you — or your competitors? Objective checks verify the metadata signals AI engines weight first. Self-mention check detects whether AI even knows you exist by name.

Action plan — copy-paste fixes

3 prioritized changes generated by gemini-2.5-flash. Mark items done after you ship the fix.

OVERALL DIRECTION

highreadme#1

Reposition the README's opening sentence and H1 to explicitly state the project's domain and type

Why:

CURRENT

# Field Theory CLI

Sync and store locally all of your X/Twitter bookmarks. Search, classify, and make them available to Claude Code, Codex, or any agent with shell access.

COPY-PASTE FIX

# Field Theory CLI: Your Local X/Twitter Bookmark Manager

The `fieldtheory-cli` is a free and open-source command-line interface (CLI) for Mac that allows you to sync, locally store, search, and manage all of your X/Twitter bookmarks. Make your saved tweets available to AI agents like Claude Code or Codex, or any shell-accessible tool.

hightopics#2

Add relevant topics to the repository

Why:

COPY-PASTE FIX

twitter, x-twitter, bookmarks, cli, command-line, social-media, archiving, data-management, macos, nodejs, ai-agents, local-storage

mediumreadme#3

Add a dedicated section in the README to highlight the 'AI agent access' use case

Why:

COPY-PASTE FIX

## Why Field Theory CLI?

Field Theory CLI is designed for users who want full control over their X/Twitter bookmarks and to leverage them with modern tools. Key benefits include:

*   **Local Ownership:** Your bookmarks, your data. Stored securely on your machine, not in the cloud.
*   **AI Agent Integration:** Seamlessly feed your curated X/Twitter content into AI agents like Claude Code, Codex, or any custom script via shell access for analysis, summarization, or content generation.
*   **Advanced Search:** Go beyond X's native search with powerful local querying capabilities.
*   **Privacy-Focused:** Free, open-source, and designed to keep your data private and under your control.

Category GEO backends resolved for this scan: google/gemini-2.5-flash, deepseek/deepseek-v4-flash

Category visibility — the real GEO test

Brand-free queries asked to google/gemini-2.5-flash. Did AI recommend you, or someone else?

Same questions for every model — switch tabs to compare answers and rankings.

Recall

0 / 2

0% of queries surface afar1/fieldtheory-cli

Avg rank

—

Lower is better. #1 = top recommendation.

Share of voice

Of all named tools, what % are you?

Top rival

Twint

Recommended in 1 of 2 queries

COMPETITOR LEADERBOARD

Twint · recommended 1×
t (the Twitter CLI client) · recommended 1×
Playwright · recommended 1×
Puppeteer · recommended 1×
SQLite · recommended 1×

CATEGORY QUERY
How can I locally store, search, and manage my X/Twitter bookmarks using a CLI?
you: not recommended
AI recommended (in order):
1. Twint
2. t (the Twitter CLI client)
3. Playwright
4. Puppeteer
5. SQLite
6. snscrape
7. twitter-api-v2
8. JSON Lines
9. CSV
10. sqlite3 CLI
11. jq
12. grep
13. awk
14. sed
AI recommended 14 alternatives but never named afar1/fieldtheory-cli. This is the gap to close.
Show full AI answer
CATEGORY QUERY
What command-line tool helps archive social media posts for AI agent access on Mac?
you: not recommended
AI recommended (in order):
1. yt-dlp (yt-dlp/yt-dlp)
2. ArchiveBox (ArchiveBox/ArchiveBox)
3. snscrape (JustAnotherArchivist/snscrape)
4. Twint (twintproject/twint)
5. wget
6. curl
AI recommended 6 alternatives but never named afar1/fieldtheory-cli. This is the gap to close.
Show full AI answer

Objective checks

Rule-based audits of metadata signals AI engines weight most.

Metadata completeness
warn
Suggestion:
README presence
pass

Self-mention check

Does AI even know your repo exists when asked about it directly?

Compared to common alternatives in this category, what is the core differentiator of afar1/fieldtheory-cli?
pass
AI named afar1/fieldtheory-cli explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
If a team adopts afar1/fieldtheory-cli in production, what risks or prerequisites should they evaluate first?
pass
AI named afar1/fieldtheory-cli explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
In one sentence, what problem does the repo afar1/fieldtheory-cli solve, and who is the primary audience?
pass
AI named afar1/fieldtheory-cli explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

Embed your GEO score

Drop this badge into the README of afar1/fieldtheory-cli. It auto-updates whenever the report is rescanned and links back to the latest report — easy public proof that you care about AI discoverability.

Live preview

MARKDOWN (README)

[![RepoGEO](https://repogeo.com/badge/afar1/fieldtheory-cli.svg)](https://repogeo.com/en/r/afar1/fieldtheory-cli)

HTML

<a href="https://repogeo.com/en/r/afar1/fieldtheory-cli"><img src="https://repogeo.com/badge/afar1/fieldtheory-cli.svg" alt="RepoGEO" /></a>

Pro

Subscribe to Pro for deep diagnoses

afar1/fieldtheory-cli — Lite scans stay free; this card itemizes Pro deep limits vs Lite.

Deep reports10 / month
Brand-free category queries5 vs 2 in Lite
Prioritized action items8 vs 3 in Lite