XURL

by v1.0.0

The `xurl` CLI provides a comprehensive interface for interacting with the X (formerly Twitter) API. It supports a wide range of authenticated operations, including posting tweets, managing replies, quotes, and deletions, reading timelines, searching, and handling direct messages. Users can also manage media uploads, follow/unfollow users, and control their X account's authentication status.

Beyond common shortcuts, `xurl` offers a powerful raw mode for making direct calls to any X v2 API endpoint, allowing for maximum flexibility. It emphasizes secure handling of authentication secrets and provides clear guidance on output formats and error handling, making it an essential tool for developers and automated systems working with the X platform.

What It Does

The `xurl` skill enables AI agents to programmatically interact with the X (formerly Twitter) API. It allows for a wide array of actions such as creating and managing posts, handling direct messages, uploading media, searching for content, managing followers, and checking authentication status. It also provides a raw API mode for direct interaction with any X v2 endpoint, offering full control over the platform's capabilities.

When To Use

Use `xurl` when an AI agent needs to automate interactions with the X platform, such as posting updates, replying to mentions, sending direct messages, retrieving user timelines, performing content searches, or managing media. It's ideal for building social media automation tools, content syndication services, or data collection agents that require authenticated access to X.

Inputs

Text content for posts/DMs, X post IDs, user handles (@handle), search queries, media file paths (images/videos), raw X API v2 endpoint paths, HTTP methods (GET, POST), and JSON payloads for raw API calls.

Outputs

JSON objects on successful API calls, non-zero exit codes on errors, and status messages for media uploads.

Limitations

Requires careful handling of authentication secrets; avoid exposing `~/.xurl` or using `--verbose` in agent sessions.
Subject to X API rate limits (429 errors), requiring back-off strategies.
Media uploads may require polling `media status` for processing completion.
Authentication failures (401/403 errors) often indicate scope or app mismatch, requiring `xurl auth status` checks.

Installation

Add to .cursor/skills/

View Cursor IDE documentation

Add to Cline skills directory

View Cline documentation

Configure in .aider.conf.yml

View Aider documentation

Add to Windsurf skills

View Windsurf documentation

Add to ~/.gemini/skills/

View Gemini CLI documentation

Add to .vscode/skills/

View VS Code documentation

What people say, and where to get help

No ratings yet. If you have used this skill, yours would be the first.

No reviews yet

This skill has not been rated. If you have run it, a short note about what you used it for helps the next person more than any description can.

Related Skills You May Like

Discover more AI agent skills in the same category to enhance your workflow automation.

Have a Skill to Share?

Join the community and help AI agents learn new capabilities. Submit your skill and reach thousands of developers.