- name
- hume-x
- description
- X/Twitter CLI and SDK for reading, searching, posting, and engagement via cookie auth.
- metadata
- {"emoji":"🐦","install":"npm install -g @humebio/hume-x","requires":{"bins":["hume-x"]}}
hume-x
Fast X/Twitter CLI using GraphQL + cookie auth. Full API coverage for tweets, timelines, search, engagement, social, lists, trending, notifications, bookmarks, likes, and scheduled tweets.
Authentication
Uses cookie-based auth. Credentials are resolved in order:
- CLI flags:
--auth-tokenand--ct0 - Environment variables:
X_AUTH_TOKEN+X_CT0(orAUTH_TOKEN+CT0) - Config file:
~/.config/hume-x/config.json - Browser cookies: Firefox (preferred) or Chrome
Run hume-x check to verify credentials. Use hume-x whoami to see the logged-in user.
Posting
hume-x tweet "hello world"
hume-x tweet "check this out" --media image.png --alt "description"
hume-x reply <id-or-url> "nice thread!"
hume-x quote <id-or-url> "interesting take"
hume-x delete <tweet-id>Supports media upload: images (jpg/png/webp), GIFs, videos with chunked upload.
Reading
hume-x read <id-or-url>
hume-x thread <id-or-url>
hume-x replies <id-or-url> -n 50Accepts tweet ID or full URL (e.g. https://x.com/user/status/123).
Timeline
hume-x home -n 30
hume-x home --following
hume-x home --cursor "abc123" --pages 3
hume-x user-tweets <username> -n 10Supports cursor-based pagination with --cursor and --pages flags.
Search
hume-x search "query" -n 20
hume-x search "from:username" -n 10
hume-x mentions
hume-x mentions --user <username>Engagement
hume-x like <tweet-id>
hume-x retweet <tweet-id>
hume-x bookmark <tweet-id>
hume-x pin <tweet-id>Collections
hume-x bookmarks
hume-x likesSocial
hume-x follow <username>
hume-x unfollow <username>
hume-x mute <username>
hume-x block <username>
hume-x following <username>
hume-x followers <username>Lists
hume-x lists
hume-x lists --member-of
hume-x list-timeline <list-id>Trending
hume-x trending
hume-x trending --tab news
hume-x trending --tab sports
hume-x trending --tab entertainmentTabs: for-you (default), trending, news, sports, entertainment.
Notifications
hume-x notificationsScheduled Tweets
hume-x schedule "future tweet" --at "2025-06-01T12:00:00Z"User Info
hume-x whoami
hume-x about <username>Utility
hume-x check # verify auth credentials
hume-x query-ids # show cached GraphQL query IDs
hume-x refresh-ids # force refresh query IDs from x.comOutput Flags
--json— parsed JSON output (pipe to jq for filtering)--json-full— raw API response JSON--plain— plain text without colors--no-color— disable ANSI colors
hume-x home --json | jq '.[0].text'
hume-x search "topic" --json -n 5Global Flags
--auth-token <token>— X auth token--ct0 <token>— X ct0 CSRF token--timeout <ms>— request timeout--proxy <url>— HTTPS/SOCKS5 proxy-n <count>— number of results (default varies by command)
Important
- Posting is rate-limited by X. If blocked, wait before retrying.
- Query IDs are auto-scraped from x.com with 24h cache. Use
hume-x refresh-idsif you get 404 errors. - Uses curl-impersonate for reliable HTTP requests to X's GraphQL API.