Guides
Task-oriented walkthroughs for the things people actually do with X from the command line.
Each guide is built around a job rather than a command: reading tweets and profiles, searching and finding people, walking the graph linked from a tweet or account, working from your own account, shaping and piping the output, and keeping a local copy in SQLite. They assume you have run the quick start.
Reading tweets
Single tweets, timelines, replies, media, threads, polls, profiles, quotes, and mentions, with the tier each one needs.
Search and discovery
Search tweets by query and product, count tweets per day, and list followers, following, likers, retweeters, and likes.
Your session
Import your X session to unlock the reads X reserves for logged-in clients: search, followers, your home timeline, and bookmarks. x is read-only.
Output and pipelines
The -o formats, --fields projection, --template rendering, piping to jq, IDs as strings, and --limit.
Graph discovery
Walk the graph linked from a tweet or user breadth-first with x discover: follow authors, quotes, replies, mentions, likers, retweeters, the follow graph, and more.
The local store
Keep a local SQLite copy of the graph: crawl breadth-first, persist a discover walk with --store, inspect with db stats and db query, manage the queue, and export to Markdown or RDF.