Twitter

X/Twitter Poster Agent

Auto-create and publish tweets and threads to X/Twitter.

What it does

1. Takes a topic/direction from the user
2. Generates tweet content (single tweet or thread)
3. Saves draft for review
4. Posts to X/Twitter via API v2

How to launch

Run the agent in the terminal:

cd ~/x-poster && python3 x-poster.py

Then interact:

x-post >> 写一条关于AI agent发展趋势的推文
x-post >> 写一个5条的thread，主题是为什么每个开发者都应该学AI
x-post >> 查看我最近发布的推文

Quick mode (non-interactive)

cd ~/x-poster && python3 -c "
from dotenv import load_dotenv; load_dotenv(override=True)
exec(open('x-poster.py').read().split('if __name__')[0])
history = [{'role': 'user', 'content': 'YOUR_TOPIC_HERE'}]
agent_loop(history)
"

Available tools in the agent

• bash — shell commands
• read_file / write_file — file/draft operations
• post_tweet — publish a single tweet (max 280 chars)
• post_thread — publish a thread (auto-chained replies)
• get_my_tweets — fetch recent tweets with engagement metrics

Writing guidelines (built into agent)

• Concise and punchy, under 280 chars per tweet
• Thread hook: first tweet grabs attention
• 2-3 hashtags, tasteful emoji use
• End with CTA (call to action)
• Agent always shows draft before posting

Configuration

• LLM API: ~/x-poster/.env (Kimi/Anthropic compatible)
• X API: ~/x-poster/.env (API Key + Access Token with Read/Write)
• Drafts: ~/x-poster/drafts/
• Post history: ~/x-poster/post_history.jsonl