xurl

Interact with the X API via CLI for posts, DMs, media, and raw access.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable developers to interact with the X API from a single CLI.

Core Features & Use Cases

  • Post, read, search, like, reply, quote, and DM on X using a single official CLI.
  • Upload media and manage posts across multiple apps and accounts, with raw API access to v2 endpoints.
  • Automate social workflows, integrate X actions into scripts, and perform maintenance tasks from CI/CD pipelines.

Quick Start

Authenticate with an X app using xurl auth oauth2 and then perform a post with xurl post 'Hello world'.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate X API posts from the command line?

You can automate X API posts from the command line by using the xurl CLI to authenticate and execute actions like posting, reading timelines, and uploading media. It handles token refresh and outputs results in JSON.

Can I manage multiple X accounts with a single CLI tool?

Yes, you can manage multiple X accounts and apps with a single CLI tool. The xurl CLI allows developers to perform maintenance tasks, switch contexts, and execute raw API access across different registered app credentials.

Does the X API require OAuth2 PKCE for CLI authentication?

The X API requires either an OAuth2 PKCE flow or registered app credentials for CLI authentication. The xurl tool handles this process automatically, managing token refresh and secure access to v2 endpoints.

What is the best way to integrate X social media actions into CI/CD pipelines?

The best way to integrate X social media actions into CI/CD pipelines is using a CLI that supports raw API access and JSON output. The xurl CLI automates social workflows, handles authentication, and performs maintenance tasks seamlessly.

How do I search and read direct messages on X using a CLI?

You can search and read direct messages on X using a CLI by leveraging the xurl tool. It provides direct access to v2 endpoints, allowing you to read timelines, search posts, and manage direct messages with JSON output.