概要

x-cli は X（旧Twitter）の公式 API v2 に直接アクセスする Python 製のコマンドラインツールです。ターミナル上からツイートの投稿、検索、タイムラインの取得、いいねやブックマークの操作など日常的な操作を行えるように設計されています。認証は同作者の x-mcp と互換性があり、x-mcp を既に設定している環境では追加設定不要で動作します。シンプルで軽量なため、開発者の実験・自動化・LLM エージェントのツールチェイン統合に向きます。

リポジトリの統計情報

スター数: 54
フォーク数: 0
ウォッチャー数: 54
コミット数: 2
ファイル数: 7
メインの言語: Python

主な特徴

X/Twitter API v2 に直接アクセスする CLI：投稿・検索・タイムライン取得・いいね・ブックマーク管理をターミナルで実行可能。
x-mcp との認証互換：同一認証情報を利用し、既存環境では追加設定が不要。
軽量な Python 実装：pyproject.toml と src 配下のモジュール構成で配布・パッケージ化が容易。
LLM フレンドリー：LLMs.md にコードベースマップやコマンド参照があり、エージェント統合を意識した設計。

技術的なポイント

x-cli は直接 API v2 にリクエストを送る設計で、サーバー側に中間レイヤを挟まずに Twitter のエンドポイントを利用します。このアプローチにより遅延が抑えられ、API の最新仕様やフィールドに素早く追従できます。認証は既存の x-mcp と互換性があるため、環境変数や設定ファイルに保存されたトークンを再利用することで導入の敷居が下がっています。パッケージ管理には pyproject.toml が用いられており、pip／Poetry 等でのインストールや配布を意識した構成です。ソースは src ディレクトリに整理されており、CLI 部分と API 呼び出しのラッパーが分離されていることが想定されます（リポジトリ規模から見て依存関係は最小限に抑えられている可能性が高い）。また、LLMs.md の存在から、コードベースのマップやエージェントが呼び出すべきコマンド一覧が用意されており、チャットボットや自動化エージェントから安全に操作できるよう配慮されています。API レスポンスの取り扱い、エラーハンドリング、Rate Limit 対策などは CLI の性質上重要な実装ポイントであり、利用者はログ出力やリトライ戦略を確認すると良いでしょう。なお、README に具体的なコマンド一覧（投稿・検索・timeline 取得など）が示されており、通常のユーザー操作からスクリプト呼び出しまで幅広く利用できます。

プロジェクトの構成

主要なファイルとディレクトリ：

.gitignore: Git 管理の除外設定。環境変数やビルド成果物を無視する設定が含まれる想定。
LLMs.md: file — コードベースマップとコマンド参照をまとめたドキュメント。LLM/AI エージェント向けの利用ガイドが記載されており、エージェント連携時に参照することが推奨されます。
README.md: file — プロジェクトの概要、使用例、必要な認証情報や x-mcp との連携方法、主要コマンドのサンプルが掲載されています。
pyproject.toml: file — プロジェクトのメタ情報、依存関係、ビルド設定。pip/Poetry 等でのインストール方法やエントリポイントの定義がここに記載されている可能性があります。
src: dir — 実際の Python パッケージコード。CLI のエントリポイント、API 呼び出しラッパー、ユーティリティが配置されています。
その他ファイル（例: ライセンス、設定テンプレートなど）: 他 2 ファイル構成から見ると、導入は比較的簡単で、既存の x-mcp を利用するユーザーは認証周りのセットアップを省略できます。CLI のコマンドはカテゴリ別に整理されており、ターミナルでの対話的利用だけでなく、自動化スクリプトや CI/CD、LLM エージェントのアクションとして組み込むことも想定されています。