How do I install the Xurl skill?

Run npx skillmds add steipete-agent-scripts/xurl in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Xurl skill do?

xurl X API CLI: install, auth, app choice, shortcuts, raw endpoints. It is listed under Integrations & APIs on SkillMD.

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Xurl?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

steipete (@steipete-agent-scripts) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Xurl by steipete-agent-scripts — Agent Skill

Name: Xurl
Rating: 4.2 (5 reviews)
Author: steipete

File contents

xurl

Official CLI for the X API.

Primary upstream: https://github.com/xdevplatform/xurl

Install

Homebrew:

brew install --cask xdevplatform/tap/xurl

npm:

npm install -g @xdevplatform/xurl

Shell script:

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

Go:

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:

xurl auth status

If an app is already registered, complete OAuth 2.0:

xurl auth oauth2

Multi-app:

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

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:

xurl /2/users/me

POST JSON:

xurl -X POST /2/tweets -d '{"text":"Hello world!"}'

Headers:

xurl -H "Content-Type: application/json" /2/tweets

Choose auth type:

xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me

Choose OAuth2 account:

xurl --username alice /2/users/me

Streaming:

xurl /2/tweets/search/stream
xurl -s /2/users/me

Quick checks

Install:

xurl version

Auth:

xurl auth status

Live request after auth:

xurl whoami

---name: xurldescription: xurl X API CLI: install, auth, app choice, shortcuts, raw endpoints.--- # 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 ```

Frequently asked questions