Skip to main content

Overview

The feed command fetches tweets from your Twitter home timeline. You can choose between the algorithmic β€œFor You” feed or the chronological β€œFollowing” feed.

Syntax

twitter feed [OPTIONS]

Options

--type
string
default:"for-you"
Feed type to fetch:
  • for-you - Algorithmic home timeline (default)
  • following - Chronological feed from accounts you follow
Alias: -t
--max
integer
Maximum number of tweets to fetch. If not specified, uses the default from your config file (typically 50).Alias: -n
--json
boolean
Output tweets as JSON instead of formatted table.
--input
string
Load tweets from a previously saved JSON file instead of fetching from Twitter.Alias: -i
--output
string
Save fetched tweets to a JSON file for later use.Alias: -o
--filter
boolean
Enable score-based filtering to remove low-quality tweets based on your filter configuration.

Examples

# Fetch your algorithmic "For You" timeline
twitter feed

Output

The command displays:
  • A formatted table with tweet content, author, engagement metrics (likes, retweets, replies)
  • Tweet timestamps
  • Filter statistics (when --filter is used)

Example Output

πŸ” Getting Twitter cookies...
πŸ“‘ Fetching home timeline (50 tweets)...

βœ… Fetched 50 tweets in 2.3s

πŸ“± Twitter β€” 50 tweets
┏━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━┳━━━━━━┳━━━━━━┓
┃ Author      ┃ Tweet               ┃ ❀️    ┃ πŸ”„   ┃ πŸ’¬   ┃
┑━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━╇━━━━━━╇━━━━━━┩
β”‚ @elonmusk   β”‚ Exciting news...    β”‚ 1.2k β”‚ 234  β”‚ 89   β”‚
β”‚ @OpenAI     β”‚ Introducing GPT...  β”‚ 5.3k β”‚ 891  β”‚ 456  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”˜
The feed command requires authentication. Make sure you’ve configured your Twitter cookies using the setup process.
Combine --output with --filter to save a curated collection of high-quality tweets for later review:
twitter feed -n 500 --filter --output curated.json
  • favorites - View your bookmarked tweets
  • search - Search for tweets by query
  • list - View tweets from a Twitter List

Build docs developers (and LLMs) love