xurl

Authenticate and send requests to the X API v2 via command line.

1|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/LuisvelMarketer/genome --skill xurl-luisvelmarketer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/LuisvelMarketer/genome/tree/main/skills/xurl
Command: npx skills add https://github.com/LuisvelMarketer/genome --skill xurl-luisvelmarketer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies interactions with the X (Twitter) API, allowing users to perform various actions like posting, replying, searching, and managing their account without needing to write complex API calls.

Core Features & Use Cases

  • Post Management: Create new posts, reply to existing ones, quote tweets, and delete your own posts.
  • Content Discovery: Search for posts using keywords, hashtags, or specific users, and view timelines or mentions.
  • User & Social Graph: Look up user profiles, follow/unfollow, and manage lists of followers and following.
  • Direct Messaging: Send and view direct messages.
  • Media Handling: Upload images and videos for use in posts.
  • Raw API Access: For advanced users, it provides a direct interface to any X API v2 endpoint.

Quick Start

Use the xurl skill to post "Hello world!" to X.

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 using the command line?

You can post to X using the command line by utilizing shortcut commands for posting, which handle the authenticated requests to the X API v2 automatically. Simply use the post shortcut command with your desired text.

Can I send direct messages and manage followers through the X API?

Yes, you can send and view direct messages, look up user profiles, and manage your social graph by following or unfollowing accounts. It provides dedicated shortcut commands for these social management actions.

How do I authenticate to the X API v2 using a CLI?

You authenticate by running the `xurl auth oauth2` command to manually verify your user credentials. The CLI then securely stores your authentication credentials in the `~/.xurl` directory for subsequent requests.

Does this tool support raw curl-style requests to any X API endpoint?

Yes, for advanced users, it provides direct raw curl-style access to any X API v2 endpoint. This allows you to bypass shortcuts and execute custom authenticated requests for unsupported actions.

What's the best way to search for posts and manage media on X?

The best way is to use the built-in content discovery shortcuts to search by keywords or hashtags, alongside media handling commands to upload images and videos for direct use in your posts.

Can I use this CLI to reply to tweets and quote posts?

Yes, the CLI supports comprehensive post management, allowing you to create new posts, reply to existing ones, quote tweets, and delete your own posts through dedicated shortcut commands.