xurl

Original：🇺🇸 English
Translated

Use the official xurl CLI for the X API. Covers install, safe auth setup, app selection, common shortcuts, and raw endpoint access.

7installs
Sourcesteipete/agent-scripts
Added on

NPX Install

npx skill4agent add steipete/agent-scripts xurl

Tags

Translated version includes tags in frontmatter
xurl-clix-apicli-toolsoauth-authenticationapi-endpoints

SKILL.md Content

View Translation Comparison →

xurl

Official CLI for the X API.
Primary upstream: https://github.com/xdevplatform/xurl

Install

Homebrew:
bash
brew install --cask xdevplatform/tap/xurl
npm:
bash
npm install -g @xdevplatform/xurl
Shell script:
bash
curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
Go:
bash
go install github.com/xdevplatform/xurl@latest

Safety

  • Never read, print, summarize, upload, or paste 
    ~/.xurl
    into LLM context.
  • Never ask the user to paste client secrets, bearer tokens, or OAuth tokens into chat.
  • Never use 
    --verbose
    in agent runs; it can expose auth headers.
  • Do not run auth commands with inline secret flags in an agent session.
  • The user must register app credentials manually on their machine outside the agent session.

Auth

Check current state:
bash
xurl auth status
If an app is already registered, complete OAuth 2.0:
bash
xurl auth oauth2
Multi-app:
bash
xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me
Notes:
  • xurl
    stores app config and tokens in 
    ~/.xurl
    .
  • OAuth 2.0 redirect URI in the X developer portal should be 
    http://localhost:8080/callback
    .
  • App registration examples with inline secrets are intentionally omitted here. Do that outside the agent session.

Common shortcuts

bash
xurl post "Hello world!"
xurl reply 1234567890 "Nice post"
xurl quote 1234567890 "My take"
xurl delete 1234567890

xurl read 1234567890
xurl search "from:elonmusk" -n 10
xurl whoami
xurl user @XDevelopers
xurl timeline -n 20
xurl mentions -n 10

xurl like 1234567890
xurl unlike 1234567890
xurl repost 1234567890
xurl unrepost 1234567890

xurl bookmark 1234567890
xurl unbookmark 1234567890
xurl bookmarks -n 10
xurl likes -n 10

xurl follow @handle
xurl unfollow @handle
xurl following -n 20
xurl followers -n 20

xurl dm @handle "message"
xurl dms -n 10

xurl media upload path/to/file.mp4
xurl media status MEDIA_ID
POST_ID
can also be a full X status URL.

Raw endpoint mode

GET:
bash
xurl /2/users/me
POST JSON:
bash
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
Headers:
bash
xurl -H "Content-Type: application/json" /2/tweets
Choose auth type:
bash
xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me
Choose OAuth2 account:
bash
xurl --username alice /2/users/me
Streaming:
bash
xurl /2/tweets/search/stream
xurl -s /2/users/me

Quick checks

Install:
bash
xurl version
Auth:
bash
xurl auth status
Live request after auth:
bash
xurl whoami