xurl

Automate X API v2 actions from a CLI with OAuth 2.0 PKCE.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This CLI delivers direct, scriptable access to X API v2, enabling developers and teams to perform common social-media actions without leaving the terminal.

Core Features & Use Cases

  • Official X developer CLI that supports shortcut commands and raw curl-style access, returning JSON to stdout for easy scripting.
  • Handles multi-app / multi-account workflows, OAuth2 PKCE with automatic token refresh, and robust authentication flows.
  • Supports posting, reading, liking, replying, following, DMs, media uploads, and direct access to any X API v2 endpoint.

Quick Start

Install xurl using one of the supported methods and run xurl --help to see available commands.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate posting to X API v2 from the command line?

A CLI tool automates X API v2 access by returning JSON to stdout, enabling scriptable social-media actions like posting, reading, and managing interactions directly from your terminal.

Does X API v2 CLI support OAuth2 PKCE and automatic token refresh?

Yes, X API v2 CLI supports OAuth2 PKCE with automatic token refresh. It handles robust authentication flows, per-app credentials, and secure token storage for multi-account workflows.

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

Yes, you can manage multiple X accounts and apps with a single CLI tool. It supports multi-app workflows with per-app credentials, allowing distinct authentication tokens for each setup.

How do I search and read X timelines or mentions programmatically?

You can search and read X timelines or mentions programmatically by executing CLI shortcut commands that query X API v2 endpoints. The tool returns JSON output to stdout for automated scripts.

What is the best way to access raw X API v2 endpoints for custom social-media automation?

The best way to access raw X API v2 endpoints for custom social-media automation is using a CLI that provides raw curl-style access. This allows hitting any X v2 endpoint directly while handling OAuth2 automatically.

How do I send direct messages or upload media via X API v2 automation?

You can send direct messages or upload media via X API v2 automation by running specific CLI commands. The tool supports DMs, media uploads, liking, and following actions, outputting results as JSON.