xurl

Post, search, and manage X/Twitter content via the official xurl CLI.

Updated May 29, 2026
One-click install
npx skills add https://github.com/Reimonsk8/hermes-9router-model-balancing --skill xurl-reimonsk8
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/Reimonsk8/hermes-9router-model-balancing/tree/main/scripts/skills/social-media/xurl
Command: npx skills add https://github.com/Reimonsk8/hermes-9router-model-balancing --skill xurl-reimonsk8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from the command line or an agent session normally requires hand-writing API calls, handling OAuth flows, and parsing responses. This Skill wraps the official xurl CLI so an agent can post, search, reply, send DMs, upload media, and call any X API v2 endpoint with simple commands that return structured JSON. ## Core Features & Use Cases - Full posting workflow: Post, reply, quote, delete, like, repost, and bookmark posts, including media uploads with server-side processing status checks. - Reading and social graph: Search posts, read timelines and mentions, look up users, and manage follows, blocks, and mutes. - Raw v2 API access: Use curl-style commands against any X API v2 endpoint for operations not covered by shortcuts, with multi-app and multi-account support. - Use Case: Ask the agent to search X for posts about your product launch, like the top results, and reply to one with a prepared message — all confirmed before any write action. ## Quick Start Ask the agent to verify xurl is authenticated with "xurl auth status" and then post "Hello world!" to your X account.

Frequently Asked Questions about xurl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I post to X/Twitter from the command line?▼

Use the xurl CLI with the command xurl post "your message" after completing one-time OAuth 2.0 setup. You can attach media by uploading a file with xurl media upload and passing the returned media ID via --media-id.

How do I search X posts and read timelines with xurl?▼

Run xurl search "query" -n 10 for recent posts, xurl timeline -n 20 for your home timeline, and xurl mentions -n 10 for mentions. All commands return structured JSON matching the X API v2 response format.

Does xurl support multiple X accounts or apps?▼

Yes, xurl stores isolated credentials per app in ~/.xurl. Switch apps with xurl auth default APP_NAME or per-request with --app, and select among multiple OAuth2 accounts with -u/--username.

Why do I get auth errors after a successful OAuth flow with xurl?▼

The token was likely saved to the built-in default app profile, which has no client credentials. Re-run xurl auth oauth2 --app my-app and then xurl auth default my-app so commands use the registered app.

Can an AI agent handle my X API credentials directly?▼

No. This Skill forbids the agent from reading ~/.xurl, accepting pasted tokens, or using inline-secret flags. The user must register the app and run xurl auth oauth2 manually outside the agent session; tokens then auto-refresh.