twitter-cli

Category: Development & Coding | Uploader: jackwener | Downloads: 0 | Version: v1.0（Latest）

CLI skill for Twitter/X to read timelines, bookmarks, user posts, and profiles from the terminal without API keys

Changelog: Source: GitHub https://github.com/jackwener/twitter-cli

Directory Structure

Current level: Root

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 531 B
  - 📄 publish-clawhub.yml 1.6 KB
  - 📄 publish.yml 578 B
📁 tests/
- 📄 conftest.py 1.1 KB
- 📄 test_cli.py 1.6 KB
- 📄 test_config.py 1.3 KB
- 📄 test_config_normalization.py 1.0 KB
- 📄 test_filter.py 879 B
- 📄 test_serialization.py 749 B
📁 twitter_cli/
- 📄 __init__.py 63 B
- 📄 auth.py 6.2 KB
- 📄 cli.py 10.0 KB
- 📄 client.py 26.4 KB
- 📄 config.py 4.3 KB
- 📄 constants.py 334 B
- 📄 filter.py 2.7 KB
- 📄 formatter.py 7.3 KB
- 📄 models.py 1.3 KB
- 📄 serialization.py 4.9 KB
📄 .gitignore 80 B
📄 config.yaml 204 B
📄 pyproject.toml 1.5 KB
📄 README.md 6.8 KB
📄 SKILL.md 1.6 KB
📄 uv.lock 111.1 KB

SKILL.md

---
name: twitter-cli
description: CLI skill for Twitter/X to read timelines, bookmarks, user posts, and profiles from the terminal without API keys
author: jackwener
version: "1.0.0"
tags:
  - twitter
  - x
  - social-media
  - terminal
  - cli
---

# 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

```bash
# Home timeline (For You)
twitter feed

# Following timeline
twitter feed -t following

# Bookmarks
twitter favorite

# Likes (own liked tweets)
twitter likes

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

## JSON / Scripting

```bash
# 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`.

```bash
twitter feed --filter
twitter favorite --filter
twitter likes --filter
```

The scoring formula:

```text
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`.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

twitter-cli

Directory Structure

SKILL.md

Report

Notice