# public-clis/twitter-cli

A CLI for Twitter/X — feed, bookmarks, and user timeline in terminal

Repository: https://github.com/public-clis/twitter-cli
Canonical: https://ross.abutalabs.com/products/twitter-cli
Language: Python
License: Apache-2.0
License Family: permissive
Last push: 2026-05-07T15:53:22+00:00

## Health v2 (maintenance only)
Score: 51/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 81, release rhythm 35, longevity 12
- inputs: {"age_days": 181, "days_push": 118, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2877, forks 269 (observed 2026-08-28T04:07:27.415858+00:00)

## What it is
A terminal-first CLI for Twitter/X that lets users read timelines, bookmarks, search results, and user profiles without official API keys, and post, reply, like, retweet, and bookmark tweets. It uses browser cookie auth with TLS fingerprint impersonation and supports structured YAML/JSON output for scripting and AI agent integration.

## Use cases
- read my twitter timeline in the terminal
- export my twitter bookmarks as
- search tweets by keyword from the command line
- post tweets and replies without the official api
- fetch a user's profile and tweets for analysis
- pipe tweet data into an ai agent via yaml output
- save a twitter article as markdown

## When to choose
- you want terminal access to Twitter/X without registering for API keys
- you need structured (JSON/YAML) tweet data for scripts or agents
- you want read and write actions (post, like, retweet, bookmark) from the CLI

## When to avoid
- you need guaranteed compliance with Twitter/X terms of service, since it bypasses the official API
- you need high-volume automation, as anti-detection delays limit throughput
- you need a GUI or rich media browsing experience

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, web-scraping, http-client, search-engine
- domain: social-media, developer-tools
- platform: cli, python, cross-platform
- tags: twitter, x, terminal, social-media-cli, cookie-auth, anti-detection, structured-output, command-line, automation

## Member repositories
- public-clis/twitter-cli (main) score 51

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:27.415858+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:48:26.791077+00:00, confidence not recorded.
  - readme: https://github.com/public-clis/twitter-cli (fetched 2026-08-28T04:07:27.415858+00:00, sha 6d3726419ab9)
- Data as of 2026-08-30T08:39:29.467469+00:00.