Files

jackwener 0a7b6a6b78 fix: console output to stderr for clean --json output

- Change Console() to Console(stderr=True) so all status/progress
  messages go to stderr, keeping stdout pure JSON when --json is used
- Add missing exception handling in likes command for fetch_user
- Fix SKILL.md: favorite -> favorites (correct command name)

2026-03-08 22:37:00 +08:00

1.5 KiB

Raw Blame History

name, description, author, version, tags

name

description

author

version

twitter-cli Skill

Use this skill when the user wants to read Twitter/X content from terminal without API keys.

Requirements

twitter-cli installed and available in PATH.
User is logged in to x.com in Chrome/Edge/Firefox/Brave, or sets:
- TWITTER_AUTH_TOKEN
- TWITTER_CT0

Core Commands

# Home timeline (For You)
twitter feed

# Following timeline
twitter feed -t following

# Bookmarks
twitter favorites

# User profile and posts
twitter user <screen_name>
twitter user-posts <screen_name> --max 20

JSON / Scripting

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

# Read from local JSON file
twitter feed --input tweets.json

Ranking Filter

Filtering is opt-in (disabled by default). Enable with --filter.

twitter feed --filter
twitter favorites --filter

The scoring formula:

score = likes_w * likes
      + retweets_w * retweets
      + replies_w * replies
      + bookmarks_w * bookmarks
      + views_log_w * log10(max(views, 1))

Configure weights and mode in config.yaml.

Safety Notes

Do not ask users to share raw cookie values in chat logs.
Prefer local browser cookie extraction over manual secret copy/paste.
If auth fails with 401/403, ask the user to re-login to x.com.

1.5 KiB Raw Blame History