xurl

Make authenticated X API v2 requests from the command line with JSON output.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables developers and agents to make authenticated, programmatic requests to the X API v2 from the command line without building custom HTTP clients, simplifying posting, reading, searching, and media workflows while keeping credentials local and out of LLM context.

Core Features & Use Cases

  • Post, reply, quote, delete, and read posts using concise CLI shortcuts for common workflows.
  • Search timelines, list followers/following, manage likes/bookmarks, send and list direct messages, and handle follow/block/mute actions.
  • Upload and track media processing, stream endpoints, or use raw curl-style access to any v2 endpoint for advanced automation and monitoring use cases.
  • Safety-first guidance: requires local authentication, instructs never to expose ~/.xurl or inline secrets to agents, and returns JSON suitable for programmatic parsing.

Quick Start

Use xurl to post a short message to X after authenticating locally with xurl auth oauth2.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I make authenticated requests to the X API v2 from the command line?

You make authenticated requests to the X API v2 from the command line by using the xurl CLI tool, which handles posting, searching, and media workflows locally with user-managed credentials stored in ~/.xurl.

Do I need to install anything before using xurl to automate X API workflows?

Yes, you need a locally installed xurl CLI tool before automating X API workflows. You must authenticate locally using xurl auth oauth2 and manage credentials in ~/.xurl without exposing secrets to agent contexts.

Can I post tweets and upload media using the X API without building a custom HTTP client?

Yes, you can post tweets and upload media using the X API without building a custom HTTP client by leveraging xurl CLI shortcuts, which handle posting, replying, quoting, and media processing tracking.

How do I search timelines and manage direct messages on X programmatically?

You search timelines and manage direct messages on X programmatically by executing xurl CLI commands that return JSON-formatted responses suitable for parsing in automation and monitoring workflows.

Does xurl support raw access to any X API v2 endpoint for advanced automation?

Yes, xurl supports raw curl-style access to any X API v2 endpoint for advanced automation, alongside streaming endpoints and standard workflows like follower management, likes, bookmarks, and block or mute actions.

How are API credentials kept secure when using a CLI tool for X API automation?

API credentials are kept secure when using a CLI tool for X API automation by storing them locally in ~/.xurl and following safety-first guidance that instructs never exposing inline secrets or configuration files to LLM agent contexts.