xurl

Executes authenticated X API v2 requests for posting, reading, and managing social content.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill xurl-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/xurl
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill xurl-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xurl.

What problem does it solve? Interacting with the X (Twitter) API normally requires writing custom HTTP clients, managing OAuth tokens, and handling endpoint-specific request formats. This Skill wraps the xurl CLI so an agent can post tweets, search posts, manage followers, send DMs, and upload media through simple commands that return structured JSON. ## Core Features & Use Cases - Posting & Engagement: Post, reply, quote, delete, like, repost, and bookmark posts using shortcut commands that accept post IDs or full URLs. - Reading & Search: Read individual posts, search recent posts, fetch home timelines, mentions, and user profiles with JSON output. - Social Graph & DMs: Follow, unfollow, block, mute, list followers/following, and send or list direct messages. - Media Upload & Raw API Access: Upload images and videos with status polling, and call any X API v2 endpoint directly with curl-style syntax. - Use Case: Ask the agent to search X for posts about your product launch, like the most relevant ones, and reply to a top post with a link to your announcement. ## Quick Start Use the xurl skill to post a tweet saying "Hello from my AI agent" after confirming authentication with xurl auth status.

Frequently Asked Questions about xurl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I post a tweet from the command line?

Run xurl post followed by your message text in quotes, such as xurl post "Hello world". You must first authenticate with xurl auth oauth2, and the command returns the created post as JSON.

How do I upload an image and attach it to a tweet?

Upload the file first with xurl media upload photo.jpg, which returns a media_id in the JSON response. Then attach it using xurl post "your text" --media-id MEDIA_ID. Videos may require polling with xurl media status until processing completes.

Can xurl access any X API v2 endpoint?

Yes, xurl supports raw curl-style access to any v2 endpoint, for example xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"Hi"}'. Shortcut commands cover common operations, while raw mode handles everything else including streaming endpoints.

Why does xurl return a 403 or 429 error?

A 403 error usually means your OAuth token lacks the required scope, so re-run xurl auth oauth2 to get a fresh token. A 429 error indicates rate limiting; wait and retry, since write endpoints have stricter limits than read endpoints.

Is it safe to pass API tokens directly to xurl commands?

No, inline secret flags like --bearer-token or --access-token must never be used in agent sessions because they can leak into logs and shell history. Credentials should be registered manually outside the agent and stored in ~/.xurl.