Infatoshi

Infatoshi / x-cli

Public

CLI for X/Twitter API v2 -- post, search, like, bookmark from your terminal

294
19
100% credibility
Found Feb 17, 2026 at 258 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A terminal-based tool for posting tweets, searching content, viewing timelines, managing bookmarks, and engaging with X (formerly Twitter) directly from the command line.

How It Works

1
🔍 Discover x-cli

You hear about a simple tool that lets you handle all your X (Twitter) activities right from your computer's command line, like posting or searching tweets.

2
🔗 Connect your X account

You go to the X developer page, create permission for the tool, and save a few special codes to link it securely to your account.

3
⚙️ Set up the tool

You download and prepare the tool on your computer, placing your connection details in a safe spot so it's ready to go.

4
🚀 Post your first tweet

You type a quick message, hit enter, and see your tweet instantly appear on X – fast and exciting!

5
📖 Read timelines and search

You check friends' posts, search for topics, or view your mentions and bookmarks with easy commands.

6
❤️ Like, retweet, or save

You quickly like a post, share it, or add it to your bookmarks just by pasting a link.

🎉 X from anywhere

Now you manage your entire X world super speedy from your terminal, feeling powerful without needing a web browser.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 258 to 294 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 x-cli?

x-cli is a Python CLI client for X/Twitter's API v2 that lets you post tweets, search recent posts, fetch timelines, like or retweet via URLs or IDs, manage bookmarks, and pull metrics--all from your terminal. It solves the hassle of switching to a browser or clunky web apps for quick X interactions, with seamless auth using five keys from the X developer portal (symlink if you use companion tools). Built with Click for commands and rich for pretty output, it supports JSON, TSV, markdown modes for piping to jq or awk.

Why is it gaining traction?

Stands out with URL/ID flexibility (paste https://x.com/user/status/123), poll creation, verbose mode for full metrics/timestamps, and troubleshooting for common x client errors like 403 oauth permissions or 429 rate limits. Developers dig the GitHub Actions integration for automated posts, cross-platform support on Linux, Ubuntu, Windows, and easy uv tool installs--no npm drama. Output formats make it script-friendly for cli github push workflows or api chaining.

Who should use this?

Terminal hackers automating X in GitHub repos or CI/CD pipelines, like devs triggering tweets on cli github actions success. AI agents/LLMs needing x client id for programmatic posting/searching, or backend folks querying user followers/timelines without SDK bloat. Skip if you're just browsing--this is for cli github copilot-style power users scripting from Ubuntu or Windows terminals.

Verdict

Grab it for early scripting wins (254 stars, solid README/manual), but 1.0% credibility score flags immaturity--test thoroughly for edge cases like basic-tier bookmark limits. MIT-licensed and Python 3.11+, worth starring as X API CLI space heats up.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.