x-cli

Read Twitter timelines, mentions, and engagement data via CLI commands.

9|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/DavidTeju/shared-skills --skill x-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-cli
Source: https://github.com/DavidTeju/shared-skills/tree/main/skills/x-cli
Command: npx skills add https://github.com/DavidTeju/shared-skills --skill x-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read-only access to Twitter timelines, mentions, and engagement data via a CLI tool.

Core Features & Use Cases

  • Read Timelines: Fetch your latest tweets or someone else's timeline.
  • Mentions & Engagement: Retrieve mentions, status details, and engagement metrics.
  • Search & Streaming: Query tweets and stream results in real time.
  • Lists Management: Create and manage lists to organize followed accounts.

Quick Start

Run x timeline @YourHandle to fetch the latest tweets from that user.

Frequently Asked Questions about x-cli

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

FAQPage Schema
How do I read Twitter timelines from the command line?

You can read Twitter timelines from the command line by running the timeline command with a specific handle. This fetches the latest tweets directly in your terminal, supporting both human-readable and CSV output formats.

Can I search tweets and stream real-time results via a CLI?

Yes, you can search tweets and stream real-time results via a CLI. The tool provides dedicated search and stream commands to query specific topics and continuously monitor live tweet matches.

What is the best way to check Twitter mentions and engagement metrics without a GUI?

The best way to check Twitter mentions and engagement metrics without a GUI is using CLI commands like mentions and status. These retrieve mention data and specific tweet engagement details directly in the terminal.

Does the x-cli tool support exporting tweet data to CSV?

Yes, the x-cli tool supports exporting tweet data to CSV. Alongside standard human-readable output, you can select CSV format to export timeline, search, and engagement data for external processing.

How do I manage Twitter lists using command line automation?

You can manage Twitter lists using command line automation by utilizing the lists command. It allows you to create and organize lists of followed accounts directly from your terminal.

Are there limitations to automating Twitter engagement data retrieval via CLI?

A key limitation of automating Twitter engagement data retrieval via this CLI is that access is strictly read-only. You can fetch and stream data, but cannot post tweets or modify account settings.