x-post

Original：🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

Post to X (Twitter) from the command line. Text, images, and video.

3installs
Sourcerameerez/claude-code-startup-skills
Added on

NPX Install

npx skill4agent add rameerez/claude-code-startup-skills x-post

Tags

Translated version includes tags in frontmatter
cli-toolx-twitter-postpython-scriptmedia-upload

SKILL.md Content

View Translation Comparison →
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):
json
{
  "api_key": "...",
  "api_secret": "...",
  "access_token": "...",
  "access_token_secret": "..."
}

Commands

Post text:
bash
python ~/.claude/skills/x-post/x-post.py post "Your tweet text"
Post with image:
bash
python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/image.jpg
Post with video:
bash
python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/video.mp4
Check profile:
bash
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