# X Post

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

- Skill: `rameerez/x-post` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add rameerez/x-post`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rameerez/x-post/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rameerez (https://skillmd.com/u/rameerez)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rameerez/x-post

---


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