xurl — X (Twitter) API CLI

xurl is a CLI tool for the X API. It supports posting tweets, searching, reading posts, managing followers, and interacting with any X API v2 endpoint.

Prerequisites

This skill requires the xurl CLI utility and X API credentials:

• X_API_KEY - Your X API key
• X_API_SECRET - Your X API secret
• X_ACCESS_TOKEN - Your access token
• X_ACCESS_SECRET - Your access token secret

Install the CLI:

# Via Homebrew
brew install --cask xdevplatform/tap/xurl

# Via npm
npm install -g @xdevplatform/xurl

# Via Go
go install github.com/xdevplatform/xurl@latest

Common Commands

Post a Tweet

xurl tweet "Your tweet content here"

Reply to a Tweet

xurl reply <tweet_id> "Your reply content"

Quote Tweet

xurl quote <tweet_id> "Your quote comment"

Search Tweets

xurl search "query" --max-results 10

Get User Tweets

xurl user <username> --limit 10

Get Tweet by ID

xurl tweet-id <tweet_id>

Get User Info

xurl user-info <username>

Follow/Unfollow

xurl follow <username>
xurl unfollow <username>

Get Followers

xurl followers <username> --limit 10

Get Following

xurl following <username> --limit 10

Send DM

xurl dm <username> "Your message"

Upload Media

xurl upload <image_path>

Post Tweet with Media

xurl tweet "Check this out!" --media <image_path>

Security Notes

• Never expose credentials in logs or chat
• Use environment variables for sensitive data
• Keep tokens secure and rotate periodically