RRepoGEO

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
0%
Of all named tools, what % are you?
Top rival
Twint
Recommended in 1 of 2 queries
COMPETITOR LEADERBOARD
  1. Twint · recommended 1×
  2. t (the Twitter CLI client) · recommended 1×
  3. Playwright · recommended 1×
  4. Puppeteer · recommended 1×
  5. 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.

RepoGEO badge previewLive 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
afar1/fieldtheory-cli — RepoGEO report