xurl

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

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill xurl-jakubbartnik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/jakubbartnik/honey-barrel-finale/tree/main/honey-barrel-finale/workspace/hermes/skills/social-media/xurl
Command: npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill xurl-jakubbartnik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from the command line or an AI agent normally requires hand-writing OAuth flows and raw API calls. This Skill wraps the official xurl CLI so an agent 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: Create posts, replies, quotes, and threads, attach images or video, and delete posts, all returning JSON. - Reading and engagement: Search posts, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages. - Raw v2 API access: Use curl-style syntax 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 your product launch, like the top results, and reply to one with a branded message including an uploaded image. ## 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 message\"" after completing one-time OAuth setup. You can attach media by first running "xurl media upload photo.jpg" and passing the returned media ID with --media-id.

How do I authenticate xurl with the X API?▼

Register an app at the X developer portal, then run "xurl auth apps add my-app --client-id ... --client-secret ..." followed by "xurl auth oauth2 --app my-app" and "xurl auth default my-app". These steps must be done manually by the user, never by an agent, since they involve secrets.

Can xurl access any X API v2 endpoint?▼

Yes, xurl supports raw curl-style access to any X API v2 endpoint, for example "xurl /2/users/me" or "xurl -X POST /2/tweets -d '{...}'". Streaming endpoints like /2/tweets/search/stream are auto-detected or forced with -s.

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. Fix it by re-running "xurl auth oauth2 --app my-app" and then "xurl auth default my-app", and verify with "xurl auth status".

Does xurl support multiple X accounts or apps?▼

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