xurl

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

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

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 raw responses. This Skill wraps the official xurl CLI so an agent can post, search, reply, like, follow, send DMs, and upload media against the X API v2 with simple commands that return structured JSON. ## Core Features & Use Cases - Full posting workflow: Create posts, replies, quotes, and threads, attach uploaded images or videos, and delete posts by ID or URL. - Search and engagement: Run raw post searches returning real post JSON with IDs, then like, repost, bookmark, or reply to results directly. - Social graph and DMs: Follow, unfollow, block, mute, list followers, and send direct messages, plus raw curl-style access to any X API v2 endpoint. - Use Case: Ask the agent to search X for posts about your product launch, like the most relevant ones, and reply to a specific thread — all executed through authenticated xurl commands with JSON output. ## 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 posts and reply to them programmatically?▼

Run "xurl search \"query\" -n 10" to get raw post JSON including IDs and authors, then use "xurl reply POST_ID \"text\"" to respond. Search results are real post objects you can immediately like, repost, or quote.

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 -u 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 set it as default with "xurl auth default my-app", then verify with "xurl auth status".

Can xurl upload videos to X?▼

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