xurl

Automate X/Twitter posting, searching, DMs, and media via the xurl CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The xurl skill provides a unified CLI to manage X/Twitter via the official API, enabling posting, searching, direct messaging, and media interactions without jumping between multiple tools.

Core Features & Use Cases

  • Post, reply, quote, delete posts
  • Read timelines, mentions, and search results; manage DMs
  • Like, repost, bookmark, and direct messaging
  • Media uploads and status checks
  • Raw API access to any X API v2 endpoint
  • Multi-app / multi-account workflows and OAuth2 token management

Quick Start

Install and configure the xurl CLI, then run a simple command such as posting a message 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 to Twitter from the command line?

You can automate posting to Twitter from the command line by using the xurl CLI, which interfaces with the official X API to execute posts, replies, and quotes. It outputs structured JSON for seamless integration into automation workflows.

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

Yes, you can manage multiple X accounts with OAuth2 using the xurl CLI. It supports multi-app and multi-account workflows, requiring tokens to be stored securely on your system for proper authentication across different profiles.

What is the best way to search the X timeline and retrieve raw API v2 results?

The best way to search the X timeline and retrieve raw API v2 results is using the xurl CLI. It provides direct raw API access to any X API v2 endpoint, returning structured JSON outputs that can be processed for timeline and mention queries.

Does the xurl CLI support direct messaging and media uploads?

Yes, the xurl CLI supports direct messaging and media uploads. It allows you to manage DMs, upload media files, and check media statuses directly through the official X API using authenticated command line commands.

Do I need to install any dependencies to use the xurl CLI for Twitter automation?

Yes, you need to install the xurl CLI itself and properly configure it with OAuth2 or app credentials. There are no other external dependencies, but secure token storage on your system is required for authentication.

Why does my Twitter API automation workflow need structured JSON outputs?

Your Twitter API automation workflow needs structured JSON outputs to parse and route data predictably across multi-account workflows. The xurl CLI generates structured JSON from raw API v2 access, enabling reliable downstream processing of posts and search results.