Run from the x-md workspace root.
Quick start
bun run read-x -- "https://x.com/handle/status/1234567890"
By default, reply chains are expanded from the root post through the URL you pass (thread=full). Use --thread off for a single post only.
Or:
bun scripts/read-x.ts "https://x.com/handle/status/1234567890" --userinfo author
Helper script (from repo root):
./skills/read-x-links-local/scripts/read-x.sh "https://x.com/handle/status/1234567890"
Setup
bun install
cp .env.local.example .env.local # optional CONTEXT_DEV_API_KEY/FIRECRAWL_API_KEY
Set X_MD_ROOT to this repo if calling the script from elsewhere.
Options
See scripts/read-x.ts: --format, --thread, --userinfo, --json, --nocache, --out.
Hosted API
For network-only reads, use read-x-links-vercel (skills/read-x-links-vercel/).