xurl

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API from an agent session normally requires writing custom HTTP clients, handling OAuth flows, and parsing raw responses. This Skill wraps the official xurl CLI so you can post, search, reply, like, repost, send DMs, and upload media with single commands that return structured JSON. ## Core Features & Use Cases - Full X API v2 coverage: Post, reply, quote, delete, search, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages. - Media uploads: Upload images and videos with server-side processing status checks, then attach them to posts via media IDs. - 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 recent posts about your product launch, like the most relevant ones, and reply to a customer question — all with verified JSON output confirming each action. ## Quick Start Ask the agent to search X for posts about a topic and reply to one of them using xurl.

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 also reply, quote, delete posts, and attach uploaded media via media IDs.

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 that can be immediately engaged with via reply, like, or repost.

Does xurl support uploading images and videos to X?▼

Yes, xurl media upload handles images and videos with auto-detected types or explicit --media-type and --category flags. Videos require server-side processing, which you can poll with xurl media status --wait MEDIA_ID.

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 registered app.

Can xurl access any X API v2 endpoint directly?▼

Yes, beyond shortcut commands, xurl supports raw curl-style access to any v2 endpoint, such as xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"Hello"}'. Streaming endpoints are auto-detected or forced with -s.