twitter-cli

Execute Twitter/X workflows from the terminal via a curl-based GraphQL client.

2.8k|256|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/public-clis/twitter-cli --skill twitter-cli-public-clis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: twitter-cli
Source: https://github.com/public-clis/twitter-cli/tree/main
Command: npx skills add https://github.com/public-clis/twitter-cli --skill twitter-cli-public-clis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

twitter-cli provides a terminal-first interface to perform all major Twitter/X operations—reading timelines, managing posts, and looking up user data without needing API keys or browser-based automation.

Core Features & Use Cases

  • Read timelines: home (For You) and following
  • Bookmarks, lists, and article export
  • Write operations: post, reply, quote, delete, like/unlike, retweet/unretweet, bookmark/unbookmark
  • User lookups and profile details
  • Structured output for scripting: YAML and JSON; compatibility with AI agents
  • Authentication: browser cookie extraction or env vars; proxy support via TWITTER_PROXY
  • Anti-detection and safe-guard features, including random delays and TLS fingerprinting
  • Optional filters for ranking tweets via a config-based scoring system

Quick Start

Install via uv tool install twitter-cli and start with twitter feed to fetch your home timeline.

Frequently Asked Questions about twitter-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Twitter X workflows from the terminal without an API key?

You can automate Twitter X workflows from the terminal by using cookie-based authentication or environment variables, bypassing the need for official API keys to read timelines and manage posts.

Can I get structured JSON or YAML output for tweets to use in automation scripts?

Yes, the CLI delivers machine-readable structured output in JSON and YAML formats, enabling seamless integration with automation scripts and AI agents for processing tweet data.

What Twitter X write operations can I execute via a command line interface?

You can execute write operations via the command line interface including posting, replying, quoting, deleting, liking, retweeting, and bookmarking tweets.

Do I need official Twitter API credentials to fetch timelines and user lookups?

No, you do not need official Twitter API credentials; the tool relies on a curl-based GraphQL client with queryId resolution and browser cookie extraction to fetch timelines and user lookups.

How does the CLI handle anti-detection when automating Twitter X requests?

The CLI handles anti-detection when automating Twitter X requests by implementing random delays and TLS fingerprinting, with optional proxy support via environment variables.

What is the best way to read and export Twitter X bookmarks from the terminal?

The best way to read and export Twitter X bookmarks from the terminal is using a CLI that fetches bookmarks and articles, outputting the results in structured YAML or JSON formats for local storage.