Claude Code + X (Twitter)
Post Tweets & Media with AI
Use the Upload-Post skill to post tweets, photo tweets, and video tweets to X (Twitter) directly from Claude Code. Automatically thread long text, post single long-form tweets, and manage your X presence from the terminal.
Install in Seconds
$ npx skills add Upload-Post/upload-post-skill Works with Claude Code, Cursor, Windsurf, and any AI coding agent that supports skills.
What You Can Post to X (Twitter)
Just Tell Your Agent
Once you've installed the skill and set your API key, simply ask Claude Code in plain English. No API calls needed.
✓ Tweet posted to X with image
Post URL: https://x.com/yourhandle/status/18493...
Features for X (Twitter)
Text Posts & Tweets
Publish text tweets to X directly from Claude Code. Compose tweets up to 280 characters, or use long text mode to bypass the character limit with auto-threading or single long-form posts.
Photo Tweets
Attach up to 4 images to a single tweet. Supports JPEG, PNG, GIF, and WebP formats. Upload-Post handles media upload, processing, and attachment to your tweet automatically.
Video Tweets
Post videos to X with captions. Supports MP4 format up to 512 MB and 140 seconds. Upload-Post manages the chunked upload process and waits for X's async video processing to complete.
Auto-Threading for Long Text
When your text exceeds 280 characters, Upload-Post automatically splits it into a numbered thread. Each tweet is broken at natural sentence boundaries to maintain readability across the thread.
Long Text as Single Post
Set x_long_text_as_post to true to publish text beyond 280 characters as a single long-form post instead of a thread. Ideal for announcements, articles, and detailed updates on X Premium accounts.
Analytics & Tracking
Monitor impressions, retweets, likes, and replies for every tweet published through Upload-Post. Track engagement trends across your X content from the Upload-Post dashboard.
How It Works
Install the Skill
Run the install command in your terminal. The skill is added to Claude Code instantly.
Connect X (Twitter)
Link your X (Twitter) account on the Upload-Post dashboard and create a profile with your API key.
Publish from Claude Code
Tell your AI agent to post content to X (Twitter). It handles formatting, uploading, and publishing automatically.
Also Works With
Frequently Asked Questions
When your caption exceeds 280 characters, Upload-Post automatically splits the text into multiple tweets and publishes them as a thread. The text is broken at natural sentence boundaries so each tweet reads well on its own. Each tweet in the thread is posted as a reply to the previous one, creating a clean numbered thread on your profile.
Setting x_long_text_as_post to true tells Upload-Post to publish your caption as a single long-form post on X instead of splitting it into a thread. This uses X's native long-form post feature, which is available to X Premium subscribers. It is ideal for detailed announcements, blog-style content, or any text you want to keep in a single tweet rather than a thread.
X supports up to 4 images per tweet (JPEG, PNG, GIF, or WebP, max 5 MB each) or 1 video per tweet (MP4, max 512 MB, up to 140 seconds). You cannot mix images and videos in the same tweet. Upload-Post validates these limits before sending to the X API and returns a clear error if your media exceeds them.
Yes. Include the schedule_date parameter with an ISO 8601 timestamp (e.g., 2026-04-10T09:00:00Z) to schedule your tweet for a specific time. The post will be published to X at the specified time. Scheduling is available on Upload-Post paid plans starting at $12/month.
Yes. Pass multiple platform names in the platform[] array — for example, platform[]=x and platform[]=linkedin — and Upload-Post will publish the same content to all specified platforms in a single API call. Each platform receives content formatted to its own requirements, so your tweet and LinkedIn post are both optimized automatically.
Start Posting to X (Twitter) from Claude Code
Join thousands of developers automating their social media workflow with AI. Free plan available.