A command-line tool for interacting with the X (formerly Twitter) API, supporting both OAuth 1.0a and OAuth 2.0 authentication.

Multi-app support — register multiple X API apps with separate credentials and tokens
OAuth 2.0 PKCE flow authentication
OAuth 1.0a authentication
Multiple OAuth 2.0 account support per app
Default app and default user selection (interactive Bubble Tea picker or single command)
Persistent token storage in YAML (~/.xurl/auth.yml), auto-migrates from the legacy single-file layout

HTTP request customization (headers, methods, body)
Per-request app override with --app
End-to-end encrypted XChat client (xurl chat) built on the official chat-xdk crypto library

brew install --cask xdevplatform/tap/xurl

npm install -g @xdevplatform/xurl

curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash

Installs to ~/.local/bin. If it's not in your PATH, the script will tell you what to add.

go install github.com/xdevplatform/xurl@latest

You must have a developer account and app to use this tool.

Installation

README.md