xurl

What This Skill Does

The xurl skill provides a powerful command-line interface (CLI) for interacting with the X (formerly Twitter) API v2. It allows agents to perform a wide range of actions on the X platform, including posting tweets, replying to existing posts, quoting tweets, searching for content, reading posts, managing follower relationships, sending direct messages, and uploading media. The skill supports both convenient, human-readable shortcut commands and raw curl-style requests for accessing any X API v2 endpoint. All operations return output in JSON format.

Installation

The xurl CLI utility can be installed through several methods:

• Homebrew (macOS):

  brew install --cask xdevplatform/tap/xurl
  

• npm:

  npm install -g @xdevplatform/xurl
  

• Shell script:

  curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
  

  This installs to ~/.local/bin. Ensure this directory is in your system's PATH.
• Go:

  go install github.com/xdevplatform/xurl@latest
  

Before using any xurl commands, ensure you have authenticated your account. Use xurl auth status to verify your authentication state.

Use Cases

This skill is ideal for automating and managing your presence on X. Common use cases include:

• Content Posting: Automatically schedule or publish tweets, including text, media, and replies.
• Social Media Monitoring: Search for specific keywords, hashtags, or mentions and retrieve relevant posts.
• Engagement Management: Reply to posts, quote tweets with commentary, and manage follower lists.
• Direct Messaging: Send and receive direct messages programmatically.
• Media Uploads: Upload images or videos to be attached to posts.
• API Exploration: Directly interact with any X API v2 endpoint for advanced functionalities.

Example Prompts

• "Post the following tweet: 'Just learned about the new OpenClaw AI skills! So exciting for automation. #OpenClawAI'"
• "Search for tweets containing the hashtag #AI, sorted by recent, and show me the first 5 results."
• "Reply to the tweet with ID 1234567890123456789 with the message: 'Great point!'"

Tips & Limitations

• Authentication is Key: All interactions require prior authentication. Users must manually set up their credentials in ~/.xurl and run xurl auth oauth2 or similar commands outside the agent session. Never share or expose your credentials.
• Secret Safety: Avoid using verbose flags (--verbose, -v) or flags that expose sensitive tokens directly in agent prompts (--bearer-token, --consumer-key, etc.) as this can lead to credential leaks. The agent will automatically use the stored credentials from ~/.xurl.
• App Management: For managing multiple X applications or accounts, use commands like xurl auth default <app_name> outside the agent session to set the active configuration.
• Output: All commands return JSON. This is useful for programmatic processing by the agent but may require parsing for human readability if not handled carefully.
• API Limits: Be mindful of X API rate limits when performing numerous operations.
• Manual Setup: The initial app registration and authentication process must be performed by the user manually on their local machine.