xitter

Interact with X/Twitter via the x-cli terminal client using official API credentials.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill xitter-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xitter
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/social-media/xitter
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill xitter-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X/Twitter activity from the terminal requires navigating the official X API's complex five-credential authentication and paid access tiers. This Skill provides a structured workflow for installing, configuring, and operating the x-cli client so agents can post, read, and search X content without browser automation or cookie scraping. ## Core Features & Use Cases - Tweet Operations: Post, reply, quote, delete, and search tweets, plus retrieve tweet metrics via simple terminal commands. - User & Timeline Lookups: Fetch user profiles, timelines, followers, and following lists, with JSON output modes for programmatic field extraction. - Authenticated Actions: Like, retweet, manage bookmarks, and check mentions using the authenticated user's account. - Use Case: A social media manager asks the agent to search recent tweets mentioning their brand, review the top results in JSON, and post a quote tweet responding to a relevant thread. ## Quick Start Use the xitter skill to search X for recent tweets about AI agents and show me the top five results.

Frequently Asked Questions about xitter

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

FAQPage Schema
How do I post tweets from the command line?▼

Install x-cli with uv tool install, configure your five X API credentials in ~/.config/x-cli/.env, then run x-cli tweet post followed by your message text. The CLI also supports replies, quotes, and deletions using tweet IDs or URLs.

What credentials does the X API require for x-cli?▼

The X API requires five credentials: X_API_KEY, X_API_SECRET, X_BEARER_TOKEN, X_ACCESS_TOKEN, and X_ACCESS_TOKEN_SECRET. Generate them in the X Developer Portal with Read and write permissions enabled, then regenerate the access token afterward.

Is the X API free to use for posting tweets?▼

No, X API access is not meaningfully free for most real usage. Expect to need paid or prepaid X developer access, and check your developer plan first if commands fail with permission or quota errors.

Why do I get 403 oauth1-permissions errors when posting?▼

This error means your access token was generated before enabling Read and write permissions. Set the permission level in your app's user authentication settings, then regenerate the access token and access token secret.

Can I get JSON output from x-cli for automation?▼

Yes, use the -j flag for machine-readable JSON output, such as x-cli -j tweet search. Add -v when you need timestamps, metrics, or metadata fields for downstream processing.