xurl

Post tweets, manage followers, and search content via the X API v2 CLI.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/spoonbobo/trinity --skill xurl-spoonbobo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/spoonbobo/trinity/tree/main/app/skills/xurl
Command: npx skills add https://github.com/spoonbobo/trinity --skill xurl-spoonbobo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a command-line interface for interacting with the X (formerly Twitter) API, enabling users to programmatically manage their posts, followers, and other account activities.

Core Features & Use Cases

  • Post Management: Create, delete, and reply to tweets.
  • User Interaction: Follow, unfollow, block, and mute users.
  • Data Retrieval: Search for posts, view user profiles, and access timelines.
  • Media Handling: Upload images and videos for use in posts.
  • Use Case: Automatically post daily updates to your X account, respond to mentions, or gather data for social media analysis.

Quick Start

Use the xurl skill to post "Hello X!" to your timeline.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate posting tweets using the X API?

You can automate posting tweets by using this CLI tool to make authenticated requests to X API v2 endpoints, utilizing shortcut commands or raw curl-style access to programmatically create and publish posts.

What is needed to authenticate with the X API v2 before posting?

To authenticate with the X API v2, you need to manually complete OAuth2 or other authentication methods, storing your credentials locally in the `~/.xurl` file before executing any CLI commands.

Can I manage followers and search content on X via command line?

Yes, you can manage followers and search content via command line by executing authenticated requests to X API v2 endpoints, enabling you to follow, unfollow, block users, and retrieve specific post data.

Does this CLI tool support uploading media for social media posts?

Yes, this CLI tool supports uploading media for social media posts by providing specific commands to upload images and videos, which can then be attached to your automated tweets.

What are the limitations of using raw curl-style access for X API requests?

Using raw curl-style access for X API requests requires precise manual configuration of endpoint URLs and parameters, meaning you must understand the X API v2 structure deeply to avoid malformed requests.

Is xurl suitable for gathering data for social media analysis?

xurl is suitable for social media analysis as it retrieves user profiles, searches posts, and accesses timelines via X API v2, providing the raw data needed for programmatic analysis workflows.