How do I install the Hume X skill?

Run npx skillmds@latest add dvcrn/hume-x in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Hume X skill do?

X/Twitter CLI and SDK for reading, searching, posting, and engagement via cookie auth. It is listed under Coding & Dev Tools on SkillMD.

Is Hume X safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hume X?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hume X free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hume X?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hume X by dvcrn — Agent Skill

Name: Hume X
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

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-token and --ct0
Environment variables: X_AUTH_TOKEN + X_CT0 (or AUTH_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 50

Accepts 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 10

Supports 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 likes

Social

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>

Notifications

hume-x notifications

Scheduled 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.com

Output 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 5

Global 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-ids if you get 404 errors.
Uses curl-impersonate for reliable HTTP requests to X's GraphQL API.

---name: hume-xdescription: X/Twitter CLI and SDK for reading, searching, posting, and engagement via cookie auth.---# hume-xFast X/Twitter CLI using GraphQL + cookie auth. Full API coverage for tweets, timelines, search, engagement, social, lists, trending, notifications, bookmarks, likes, and scheduled tweets.## AuthenticationUses cookie-based auth. Credentials are resolved in order:1. CLI flags: `--auth-token` and `--ct0`2. Environment variables: `X_AUTH_TOKEN` + `X_CT0` (or `AUTH_TOKEN` + `CT0`)3. Config file: `~/.config/hume-x/config.json`4. Browser cookies: Firefox (preferred) or ChromeRun `hume-x check` to verify credentials. Use `hume-x whoami` to see the logged-in user.## Posting```bashhume-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```bashhume-x read <id-or-url>hume-x thread <id-or-url>hume-x replies <id-or-url> -n 50```Accepts tweet ID or full URL (e.g. `https://x.com/user/status/123`).## Timeline```bashhume-x home -n 30hume-x home --followinghume-x home --cursor "abc123" --pages 3hume-x user-tweets <username> -n 10```Supports cursor-based pagination with `--cursor` and `--pages` flags.## Search```bashhume-x search "query" -n 20hume-x search "from:username" -n 10hume-x mentionshume-x mentions --user <username>```## Engagement```bashhume-x like <tweet-id>hume-x retweet <tweet-id>hume-x bookmark <tweet-id>hume-x pin <tweet-id>```## Collections```bashhume-x bookmarkshume-x likes```## Social```bashhume-x follow <username>hume-x unfollow <username>hume-x mute <username>hume-x block <username>hume-x following <username>hume-x followers <username>```## Lists```bashhume-x listshume-x lists --member-ofhume-x list-timeline <list-id>```## Trending```bashhume-x trendinghume-x trending --tab newshume-x trending --tab sportshume-x trending --tab entertainment```Tabs: `for-you` (default), `trending`, `news`, `sports`, `entertainment`.## Notifications```bashhume-x notifications```## Scheduled Tweets```bashhume-x schedule "future tweet" --at "2025-06-01T12:00:00Z"```## User Info```bashhume-x whoamihume-x about <username>```## Utility```bashhume-x check # verify auth credentialshume-x query-ids # show cached GraphQL query IDshume-x refresh-ids # force refresh query IDs from x.com```## Output 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```bashhume-x home --json | jq '.[0].text'hume-x search "topic" --json -n 5```## Global 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-ids` if you get 404 errors.- Uses curl-impersonate for reliable HTTP requests to X's GraphQL API.

Frequently asked questions

Hume X