xurl - X

xurl is a curl-like command-line tool for the X API. It handles OAuth authentication automatically so you can make API requests without manually managing tokens or signing requests.

GitHub repository

Source code, releases, and documentation.

Installation

Install with Go, or download a pre-built binary from releases.

go install github.com/xdevplatform/xurl@latest

Setup

Authorize xurl with your X API credentials on first use:

xurl auth

This opens a browser-based OAuth flow. Once authorized, xurl stores your tokens locally so you don’t need to authenticate again.

Usage

Raw API requests

Use xurl like curl — it handles auth headers automatically:

# Look up a user
xurl /2/users/by/username/xdevelopers

# Search recent posts
xurl "/2/tweets/search/recent?query=from:xdevelopers&max_results=10"

# Create a post
xurl -X POST /2/tweets -d '{"text": "Hello from xurl!"}'

Shortcut commands

xurl includes built-in shortcuts for common operations:

# Look up a user by username
xurl user xdevelopers

# Search recent posts
xurl search "X API"

# Post a tweet
xurl post "Hello from xurl!"

Why use xurl?

Feature	curl	xurl
Authentication	Manual OAuth header setup	Automatic — just run `xurl auth` once
Token management	You handle refresh/rotation	Built-in token storage and refresh
API shortcuts	Full URL required	Shorthand commands for common tasks
Request signing	Manual OAuth 1.0a signing	Automatic for all requests

Using xurl with AI agents

xurl includes a SKILL.md file that describes its capabilities in a machine-readable format. AI agents can use this to understand how to invoke xurl commands on your behalf.

npx skills add https://github.com/xdevplatform/xurl

Make your first request

Get started with the X API using cURL or SDKs.

API Playground

Test endpoints locally with mock data — no API credits needed.

GitHub repository

​Installation

​Setup

​Usage

​Raw API requests

​Shortcut commands

​Why use xurl?

​Using xurl with AI agents

​Related