xitter

Post, search, and manage X/Twitter content via the x-cli terminal client.

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill xitter-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xitter
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/social-media/xitter
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill xitter-mlt-oss

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 x-cli, configuring credentials, and executing read and write operations without building custom API integrations. ## Core Features & Use Cases - Tweet Operations: Post, reply, quote, delete, and search tweets, plus retrieve metrics for any tweet ID or URL. - User & Timeline Lookups: Fetch user profiles, timelines, followers, and following lists with configurable result limits. - Authenticated Actions: Like, retweet, bookmark, and check mentions using your own account credentials. - Structured Output Modes: Use -j for JSON, -md for Markdown, and -v for verbose metadata when piping results into agent workflows. - Use Case: An agent monitoring brand mentions can run x-cli me mentions --max 20 -j, parse the JSON results, and draft quote-tweet responses after user confirmation. ## Quick Start Ask the agent to verify x-cli is installed and credentials are configured, then search X for recent tweets about a topic of your choice.

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 via tweet subcommands.

How to search tweets using the X API from terminal?

Run x-cli tweet search with your query string and a --max limit, for example x-cli tweet search "AI agents" --max 20. Add the -j flag for JSON output when you need to parse results programmatically.

What credentials does the X API require for read and write access?

The official X API requires five values: X_API_KEY, X_API_SECRET, X_BEARER_TOKEN, X_ACCESS_TOKEN, and X_ACCESS_TOKEN_SECRET. Generate them in the X Developer Portal after setting your app's user authentication permissions to Read and write.

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

This error means your access token was generated before enabling Read and write permissions. Regenerate the access token and secret in the X Developer Portal after updating permissions, then update your .env file.

Is the X API free to use for posting and searching?

No, X API access is not meaningfully free for most real usage and typically requires a paid or prepaid developer plan. If commands fail with quota or permission errors, check your X developer plan first.

When should I use quote tweets instead of replies?

X restricts many programmatic replies, so tweet quote is often more reliable than tweet reply for automated workflows. Use replies only when you have confirmed the target tweet allows them.