xurl

Automates X API interactions via the official xurl CLI for posts, replies, likes, and DMs.

1|Updated Apr 30, 2025
One-click install
npx skills add https://github.com/lucasfth/config --skill xurl-lucasfth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/lucasfth/config/tree/main/.hermes/skills/social-media/xurl
Command: npx skills add https://github.com/lucasfth/config --skill xurl-lucasfth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interact with X via the official X API CLI to manage posts, timelines, DMs, and other actions without switching to a web UI.

Core Features & Use Cases

  • Post, reply, quote, like, repost, and bookmark across timelines and mentions
  • Read timelines, search, user lookup, and direct messages; manage follows and blocks
  • Raw API access to any X API v2 endpoint and support for multi-app / multi-account workflows

Quick Start

Install xurl on your system and run a starter command to post a message or read 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 Twitter posts and interactions using the X API CLI?

You can automate Twitter posts, replies, likes, and direct messages by using the xurl CLI to interact with the X API. It handles reading timelines, searching, and media uploads with structured JSON outputs.

Does the X API CLI support multi-account workflows and OAuth 2.0?

Yes, the X API CLI supports multi-app and multi-account workflows using OAuth 2.0 PKCE with auto-refresh. It securely stores your account credentials in YAML format under the ~/.xurl directory.

How do I read timelines and search tweets from the command line?

You can read timelines and search tweets by executing specific xurl CLI commands that query the X API v2. The tool returns the results as structured JSON data, including built-in error handling for reliable parsing.

Can I access raw X API v2 endpoints for custom Twitter automation?

Yes, xurl provides raw API access to any X API v2 endpoint, allowing you to perform custom Twitter automation beyond standard posting and reading. This enables flexible management of follows, blocks, and user lookups.

What is the best way to manage Twitter direct messages and media uploads via CLI?

The best way to manage DMs and media uploads is using the xurl CLI, which directly interfaces with the X API. It processes these actions locally and outputs structured JSON responses for easy integration into automated workflows.