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.