xurl

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

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/decniner/HermesP1 --skill xurl-decniner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/decniner/HermesP1/tree/main/.hermes-backup/skills/social-media/xurl
Command: npx skills add https://github.com/decniner/HermesP1 --skill xurl-decniner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from the command line or an agent session normally requires hand-writing OAuth flows and raw API calls. This Skill wraps the official xurl CLI so you 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 search: Search posts, read timelines and mentions, look up users, and access any X API v2 endpoint in raw curl-style mode. - Social graph and DMs: Follow, block, mute, list followers, and send direct messages, with multi-app and multi-account credential 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 branded message — all executed through authenticated xurl commands returning JSON. ## 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 text\"" 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/Twitter posts using the API?▼

Run "xurl search \"query\" -n 10" to search posts with a result limit. The command supports X search operators like from:, lang:, and hashtags, and returns structured JSON matching the X API v2 response format.

Does xurl support multiple X accounts or apps?▼

Yes, xurl supports multiple registered apps with isolated credentials and multiple user accounts per app. Switch with "xurl auth default APP USER" or per-request using the --app and --username flags.

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" to bind the token to your named app.

Can xurl upload videos to X/Twitter?▼

Yes, upload videos with "xurl media upload video.mp4", then poll processing status with "xurl media status --wait MEDIA_ID". Once processing completes, attach the media ID to a post with the --media-id flag.