xurl

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill xurl-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill xurl-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API normally requires writing custom HTTP clients, handling OAuth flows, and parsing raw responses. This Skill wraps the official xurl CLI so an agent can post, search, reply, like, follow, send DMs, and upload media on X using simple commands that return structured JSON. ## Core Features & Use Cases - Full X API v2 coverage: Post, reply, quote, delete, search raw posts, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages. - Media uploads: Upload images and videos, poll processing status, and attach media IDs to posts. - Raw endpoint access: Run curl-style requests against any X API v2 endpoint, including streaming endpoints, with multi-app and multi-account credential support. - Use Case: Ask the agent to search X for posts about a product launch, like the most relevant ones, and reply to a specific post with an attached image — all executed through authenticated xurl commands returning verifiable JSON. ## Quick Start Ask the agent to check xurl auth status and then search X for the five most recent posts about a topic you care about.

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 to search X posts and get raw JSON results?▼

Run xurl search "query" -n 10 to query the X index as your authenticated account. It returns raw post objects with IDs, authors, and full text, so results can be immediately engaged with via reply, like, or repost.

Does xurl support multiple X accounts or apps?▼

Yes, xurl supports multiple registered apps with isolated credentials and multiple accounts per app. Switch with xurl auth default APP USER, or use --app and -u/--username flags for per-request selection.

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?▼

Yes, xurl media upload handles video files with server-side processing. Poll the processing state with xurl media status MEDIA_ID or use --wait, then attach the media ID to a post once processing completes.