The gist

superx is a community-built command-line interface that provides a wrapper around the Grok Build CLI. It enables AI agents and developers to query X/Twitter data through commands for user search, keyword search, semantic search, and thread fetching. It also solves the problem of repeated data fetching by caching X posts and articles as local Markdown files within a project, making the data reusable for agents.

What it does

Search for X/Twitter users by name, keyword, or handle.
Query posts using advanced X search syntax.
Perform semantic searches for posts using natural language.
Fetch complete conversation threads, including parent posts and replies.
Save the full text of X articles and posts as local Markdown files.

How it works

The user runs superx commands from their terminal. The tool primarily calls the native X tools available through the Grok Build CLI, returning data as JSON. A key feature is its caching mechanism, which saves fetched articles as Markdown files in a local directory for agents to read directly. The tool is open-source and written in Python, but its core functions require a paid SuperGrok or X Premium+ subscription.

Best for

This tool is best for developers building AI agents or automation scripts that need to reliably query X/Twitter data and store the results locally for repeated use.

Watch out for

Most core functions, such as user, keyword, and semantic search, depend entirely on the Grok Build CLI and require a paid SuperGrok or X Premium+ subscription to work. Without this subscription, only the article fetching command is available via a fallback method.