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.

2installs

Sourcesteipete/agent-scripts

Added on2026-04-26

NPX Install

npx skill4agent add steipete/agent-scripts xurl

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

xurl

NPX Install

Tags

SKILL.md Content

xurl

Install

Safety

Auth

Common shortcuts

Raw endpoint mode

Quick checks