luna/twitter-cli-cookiefile
1
0
Fork 0
Code Issues Pull Requests Actions Releases Activity

Update README for fork and multi-account workflow
All checks were successful
CI / test (3.11) (push) Successful in 51s
Details
CI / test (3.10) (push) Successful in 52s
Details
CI / test (3.12) (push) Successful in 43s
Details

Browse Source
This commit is contained in:
Luna
2026-05-08 17:03:28 +02:00
parent 62c412ab88
commit 9b789e24cb
1 changed files with 26 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
README.md
View File

@@ -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: