xurl

xurl wraps the X API v2 with two layers of access:Shortcut commands — friendly one-liners like xurl post "Hello!", xurl search "#buildinpublic", or xurl dm @handle "message" that cover the most common operations.Raw API access — pass any v2 endpoint path directly (e.g. xurl /2/users/me) for full flexibility, with support for custom HTTP methods, headers, and request bodies.Credentials are stored securely in ~/.xurl and never exposed to agent context. OAuth 2.0 tokens refresh automatically. Multiple apps and accounts can be registered and switched between using xurl auth default or the --app flag per request.

Post & Engage — Create posts, replies, quote tweets, likes, reposts, and bookmarks with single commands.Search & Read — Search recent posts with full query syntax support; read individual posts with author, metrics, and entities.Social Graph Management — Follow, unfollow, block, unblock, mute, and unmute users; list followers and following for any account.Direct Messages — Send DMs and list recent DM events.Media Upload — Upload images and videos with auto type detection; poll processing status for videos.Raw v2 Access — Hit any X API v2 endpoint with GET, POST, PUT, PATCH, or DELETE, including streaming endpoints.Multi-App & Multi-Account — Manage multiple registered apps and multiple OAuth2 accounts per app; switch between them on the fly.JSON Output — All commands return pretty-printed JSON to stdout, matching the X API v2 response format for easy parsing.

X Developer App Credentials — Required. You must register an app on the X Developer Portal and configure credentials manually outside any agent session. OAuth 2.0 is the recommended auth method; OAuth 1.0a and app-only auth are also supported. Credentials are stored in ~/.xurl and must never be passed through agent context.

Social Media Automation — Schedule and post content, reply to mentions, and engage with relevant posts automatically as part of a larger AI workflow.Content Research — Search X for topics, hashtags, or specific accounts and feed the JSON results into downstream analysis or summarization steps.Community Management — Monitor mentions, manage follower/following lists, block spammers, and send DMs at scale.Media Publishing — Upload images or videos and attach them to posts in a two-step workflow, enabling rich media publishing from automated pipelines.