xurl

Manage X posts, timelines, DMs, and API actions via the xurl CLI.

1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/chrisliu298/dotfiles --skill xurl-chrisliu298
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/chrisliu298/dotfiles/tree/main/agents/extensions/skills/xurl
Command: npx skills add https://github.com/chrisliu298/dotfiles --skill xurl-chrisliu298

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interact with X (Twitter) via xurl, the official X API CLI. Use for posting, replying, quoting, deleting, searching, reading timelines/mentions, liking, reposting, bookmarking, following, DMs, media upload, and raw v2 endpoint access. Triggers on "post to X", "tweet this", "reply to [X/Twitter post]", "search X for", "my mentions on X", "X timeline", "send a DM on X", "xurl", or any request that names an X/Twitter post URL (x.com/.../status/...) and asks to read, react to, or engage with it. Do NOT trigger on bare "X" when the user means something else (variable names, unknowns, the letter). Invoke with "xurl". user-invocable: true allowed-tools: Bash(xurl:*)

Core Features & Use Cases

  • Post, reply, quote, and delete tweets
  • Read timelines, mentions, and user data
  • Search, like, bookmark, and follow/unfollow actions
  • Direct messages and media upload
  • Raw API access for advanced workflows and tooling

Quick Start

Install xurl, configure an app, authenticate, and run a sample command such as xurl whoami to verify access.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I manage X timelines and posting directly from the command line?

You can manage X timelines and posting from the command line using xurl, the official CLI. It supports posting, reading, searching, and liking across multiple accounts, returning all results as JSON for terminal-based workflows.

Can I send direct messages and search X via the API CLI?

Yes, the xurl CLI supports sending direct messages and searching X. It provides command-line access to DMs, timeline reading, and raw v2 endpoint interactions, requiring proper app configuration and authentication beforehand.

Do I need to configure authentication before using the xurl CLI for Twitter?

Yes, using the xurl CLI requires installing the tool, configuring an official X app, and completing proper authentication flows. You can verify your access by running a sample command such as xurl whoami.

What is the best way to access raw X API v2 endpoints from the terminal?

The best way to access raw X API v2 endpoints from the terminal is using xurl. It offers raw API access for advanced workflows and tooling, allowing you to execute complex queries and return structured JSON output.

Does the xurl CLI support managing multiple X accounts simultaneously?

Yes, the xurl CLI supports managing multiple X accounts simultaneously. You can interact with various accounts to handle posts, timelines, direct messages, and follow actions directly from your terminal.