diff --git a/README.md b/README.md index f54dd07..0de999d 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,8 @@ A terminal-first CLI for Twitter/X: read timelines, bookmarks, and user profiles without API keys. +> **Fork note:** This repository is a private fork of [`public-clis/twitter-cli`](https://github.com/public-clis/twitter-cli) with extra cookies.txt auth support, multi-account usage via per-command `TWITTER_COOKIE_FILE=...`, and a repo-local OpenClaw skill. + ## More Tools - [xiaohongshu-cli](https://github.com/jackwener/xiaohongshu-cli) — Xiaohongshu (小红书) CLI for notes and account workflows @@ -74,11 +76,17 @@ uv tool upgrade twitter-cli Install from source: ```bash -git clone git@github.com:jackwener/twitter-cli.git -cd twitter-cli +git clone ssh://gitea@gitea.reversed.dev:2222/luna/twitter-cli-cookiefile.git +cd twitter-cli-cookiefile uv sync ``` +Original upstream project: + +```bash +git clone git@github.com:jackwener/twitter-cli.git +``` + ### Quick Start ```bash @@ -186,6 +194,14 @@ TWITTER_COOKIE_FILE=/path/to/account-b.cookies.txt twitter whoami This keeps the CLI multi-account friendly: no cookie path is pinned in config, so each command can target a different account cleanly. +Examples: + +```bash +TWITTER_COOKIE_FILE=/root/twitter_cookies/space.txt twitter whoami --json +TWITTER_COOKIE_FILE=/root/twitter_cookies/betternews.txt twitter whoami --json +TWITTER_COOKIE_FILE=/root/twitter_cookies/bundesamt.txt twitter whoami --json +``` + Browser extraction is recommended — it forwards ALL Twitter cookies (not just `auth_token` + `ct0`) and aligns request headers with your local runtime, which is closer to normal browser traffic than minimal cookie auth. **Chrome multi-profile**: All Chrome profiles are scanned automatically. To specify a profile: @@ -216,6 +232,14 @@ export TWITTER_PROXY=socks5://127.0.0.1:1080 Using a proxy can help reduce IP-based rate limiting risks. +### OpenClaw Skill + +This fork includes a repo-local skill for OpenClaw: + +- `skill/SKILL.md` + +It documents the intended multi-account workflow: activate the repo venv and always pass `TWITTER_COOKIE_FILE=...` per command. + ### Configuration Create `config.yaml` in your working directory: