xurl

Execute X API operations via xurl CLI with JSON output.

Updated May 4, 2026
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill xurl-jamesfincher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/JamesFincher/gengar/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/JamesFincher/gengar --skill xurl-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of interacting with the X (Twitter) API by giving you a single command-line interface for posting, reading, searching, and messaging.

Core Features & Use Cases

  • Post, Reply, Quote, Delete: Create tweets and manage engagement actions like replies, quotes, and removals with JSON output for downstream use.
  • Search, Timelines, Mentions, Users: Query posts by topic, handle, or hashtags while retrieving timelines/mentions and user lookups.
  • Engage and Social Graph: Like/repost/bookmark, and manage follow/block/mute actions to coordinate outreach workflows.
  • DMs and Media Upload: Send direct messages and upload media (images/video), then post using returned media IDs.

Quick Start

Ask the agent to post to X by running: xurl post "Hello from gengar!".

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 and threads from the command line?

You can post tweets by running the xurl CLI to execute authenticated X API operations, which outputs JSON responses for downstream workflow integration. It supports creating posts, replies, quotes, and deleting content directly.

Do I need to manually configure OAuth2 credentials to use the X API CLI?

Yes, you must manually configure your OAuth2 credentials in the ~/.xurl directory before running commands. Once configured, the CLI handles authentication for posting, searching, and managing social actions automatically.

Can I upload media images and video to X through a command-line interface?

Yes, the xurl CLI supports media upload for images and video, returning media IDs. You use those returned media IDs to attach the uploaded media to your tweets and threads.

What's the best way to search X posts and monitor mentions for specific hashtags?

The best way to search X posts and monitor mentions is using the xurl CLI to query posts by topic, handle, or hashtags. It retrieves timelines and mentions while emitting structured JSON responses to standard output.

How do I send direct messages on X using a CLI workflow?

You send direct messages by running xurl CLI commands after configuring your credentials in ~/.xurl. The CLI handles DM operations and outputs JSON responses, allowing you to integrate messaging into automated workflows.

How do I manage follow, block, and mute actions for X outreach coordination?

You manage follow, block, and mute actions by executing xurl CLI commands for social graph management. The CLI applies these engagement actions and returns JSON responses to coordinate your outreach workflows.