skills.rest
hugotown
hugotownCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

xurl

Post, search, and manage X/Twitter content via the official xurl CLI and v2 API.

Updated Oct 16, 2025
Search Tags:#social media#cli#twitter#oauth2#x api#xurl#post automation
One-click install
npx skills add https://github.com/hugotown/dotfiles --skill xurl-hugotown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/hugotown/dotfiles/tree/main/hermes/skills/social-media/xurl
Command: npx skills add https://github.com/hugotown/dotfiles --skill xurl-hugotown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from the command line or an agent session normally requires hand-writing OAuth flows and raw API calls. This Skill wraps the official xurl CLI so an agent can post, search, reply, send DMs, upload media, and call any X API v2 endpoint while keeping credentials out of the conversation. ## Core Features & Use Cases - Full X API coverage: Post, reply, quote, delete, like, repost, bookmark, follow, block, mute, DM, and upload media, plus raw curl-style access to any v2 endpoint. - Secret-safe operation: Enforces strict rules so tokens in ~/.xurl are never read, printed, or sent into LLM context; auth setup is always done by the user outside the agent session. - Multi-app and multi-account support: Switch between registered apps and OAuth2 accounts with --app and --username flags, with auto-refreshing OAuth 2.0 PKCE tokens. - Use Case: Ask the agent to search recent posts about a topic, like the most relevant ones, and reply to one — it verifies auth status first, confirms intent before writes, and returns structured JSON results. ## Quick Start Ask the agent to check xurl auth status and then post "Hello world" to your X account.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I post to X/Twitter from the command line?▼

Use the xurl CLI with the command xurl post "your text" after completing one-time OAuth setup. You can attach media by uploading first with xurl media upload and passing --media-id to the post command.

How do I authenticate xurl with the X API?▼

Register an app at the X developer portal, then run xurl auth apps add with your client ID and secret, followed by xurl auth oauth2 --app your-app to complete the OAuth 2.0 PKCE flow. These steps must be done manually outside any agent session because they involve secrets.

Can xurl access any X API v2 endpoint?▼

Yes, xurl supports raw curl-style access to any v2 endpoint, for example xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"Hello"}'. Shortcut commands cover common actions, and raw mode handles everything else.

Why do I get auth errors after a successful OAuth flow with xurl?▼

The token was likely saved to the built-in default app profile, which has no client credentials. Re-run xurl auth oauth2 --app your-app and then xurl auth default your-app so commands use the registered app.

Does xurl support multiple X accounts or apps?▼

Yes, each registered app has isolated credentials and tokens. Switch with xurl auth default APP USER for a persistent default, or use --app and --username flags for per-request overrides.

Related Skills

Explore More Marketing & Sales Skills→
519lab519lab
2

xurl

Manage X/Twitter API interactions via the xurl CLI.

Official
Intermediate
InsightpulseaiInsightpulseai

Performance Review

Analyze social media engagement metrics and KPIs to generate strategy recommendations.

Official
Intermediate
nexscope-ainexscope-ai
632

social-media-monitor

Monitor social media mentions, trends, and competitor activity across platforms.

Official
Intermediate
gqf2008gqf2008

xurl

Control X API v2 via the official xurl CLI for posting, reading, and searching.

Community
Advanced