x-post

---

name: x-post description: Post to X (Twitter) from the command line. Text, images, and video. argument-hint: "post "Your tweet text" [--media /path/to/file]" allowed-tools: Bash, Read model: claude-haiku-4-5-20251001

Post to X using the CLI tool at ~/.claude/skills/x-post/x-post.py.

Setup

Requires Python packages: pip install xdk requests_oauthlib

Credentials file at ~/.claude/skills/x-post/x.key (JSON):

{
  "api_key": "...",
  "api_secret": "...",
  "access_token": "...",
  "access_token_secret": "..."
}

Commands

Post text:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text"

Post with image:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/image.jpg

Post with video:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/video.mp4

Check profile:

python ~/.claude/skills/x-post/x-post.py me

Rules

• Always show the user the exact tweet text before posting and get confirmation
• Never post without explicit user approval
• Video uploads use chunked upload (INIT/APPEND/FINALIZE) and may take a minute for processing
• The script auto-detects media type from file extension