Skip to main content

Twitter CLI

Control Twitter/X from your terminal. No API keys required — just browser cookies.

Key Features

No API Keys

Use browser cookies for authentication. No Twitter API application required.

Read Everything

Fetch timelines, bookmarks, search results, user profiles, and tweet details.

Write Operations

Post tweets, like, retweet, bookmark, and delete from the command line.

Advanced Filtering

Score and rank tweets by engagement with customizable weights.

JSON Export

Export any data to JSON for scripting and automation.

Anti-Detection

TLS fingerprint impersonation and request timing to avoid rate limits.

Quick Example

# Fetch your home timeline
twitter feed

# Search for tweets
twitter search "AI agents"

# Post a tweet
twitter post "Hello from the command line!"

# Export to JSON
twitter feed --json > tweets.json

Get Started

Installation

Install with uv, pipx, or from source

Quickstart

Get up and running in 5 minutes

Commands

Explore all available commands

Documentation

Read Commands

Fetch timelines, bookmarks, search, and user data

Write Commands

Post, like, retweet, bookmark, and delete tweets

Configuration

Set up authentication, filtering, and proxy settings

Best Practices

Avoid rate limits and protect your account

Build docs developers (and LLMs) love