xurl

Operate the X API v2 through the official xurl CLI with JSON output.

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill xurl-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/automation-skills/social-media/xurl
Command: npx skills add https://github.com/yakeworld/Synthos --skill xurl-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Interacting with the X (Twitter) API normally requires writing HTTP clients, managing OAuth tokens, and parsing responses by hand. This Skill wraps the official xurl CLI so an agent can post, search, read, and engage on X using simple commands that return structured JSON, while enforcing strict credential-safety rules. ## Core Features & Use Cases - Full X API v2 coverage: Post, reply, quote, delete, search, read timelines and mentions, like, repost, bookmark, follow, block, mute, send DMs, and upload media — plus raw curl-style access to any v2 endpoint. - Multi-app and multi-account auth: OAuth 2.0 PKCE with auto-refreshing tokens, per-app credential isolation, and account switching via --app and --username flags. - Mandatory secret safety: The agent never reads ~/.xurl, never uses --verbose or inline-secret flags, and directs all credential registration and OAuth flows to the user outside the session. - Use Case: Ask the agent to search X for posts about a topic, like the most relevant ones, and reply to one — it verifies auth status first, confirms your intent before any write action, and returns parsed JSON results. ## Quick Start Ask the agent to check xurl auth status and then search X for 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 setup. For images, run xurl media upload photo.jpg first, then pass the returned ID with --media-id.

How do I search X posts using the X API v2?

Run xurl search "your query" -n 10 to get up to 10 matching posts as JSON. The query supports standard X search operators like from:user, hashtags, and lang: filters.

Why do I get 403 or UsernameNotFound after xurl OAuth?

This happens when the token was saved to the empty default app profile or the /2/users/me lookup fails. Re-run xurl auth oauth2 --app my-app YOUR_USERNAME with your handle explicitly, then set xurl auth default my-app.

Can an AI agent safely use xurl with my X credentials?

Yes, under strict rules: the agent only checks xurl auth status and never reads ~/.xurl, never uses --verbose, and never passes inline secret flags. All credential registration and OAuth flows must be done by you manually outside the agent session.

Does xurl support multiple X accounts or apps?

Yes, each registered app has isolated credentials and tokens. Switch apps with xurl auth default APP or per-request with --app NAME, and select among multiple accounts per app using -u/--username.

How do I upload video to X with xurl?

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