rome-os X (Twitter) Operations Guide
Overview
This skill covers the full X (Twitter) account management workflow using browser automation
via opencli twitter commands. The app provides actions for login checking, brand voice
learning, content creation, comment replies, and metrics polling.
Prerequisites
Before any X operation, the user must be logged in to X in the desktop browser.
Use x_check_login to verify. If not logged in, direct the user to desktop browser
to log in at https://x.com.
Available Actions
| Action | Purpose | Side Effects |
|---|---|---|
x_check_login |
Check if user is logged in to X | read-only |
x_learn_brand_voice |
Analyze tweets and save brand voice to memory | write |
x_fetch_tweets |
Fetch recent tweets from a user | read-only |
x_post_tweet |
Post a new tweet | write |
x_reply_tweet |
Reply to a specific tweet | write |
x_fetch_notifications |
Fetch recent notifications | read-only |
x_poll_metrics |
Poll tweet metrics and process new comments | write |
Available Agents
Content Editor (content-editor)
Creates and edits tweets/threads based on topics or reference material. Always loads the brand voice file first and never posts without user approval.
Comment Reply (comment-reply)
Drafts replies to incoming comments and mentions. Loads brand voice for tone matching. Presents drafts for user review before posting.
Workflow: First-Time Setup
- Check login: Run
x_check_login - Learn brand voice: Run
x_learn_brand_voiceto analyze the account and create a memory file atmemory/x-{username}-brand-voice.md - Set up polling: Run
x_poll_metricswithsetupSchedule: trueto start 15-minute recurring checks
Workflow: Content Creation
- Load brand voice from
memory/x-{username}-brand-voice.md - Create content matching the user's voice and style
- Present draft to user for review
- On approval, post via
x_post_tweet
Workflow: Comment Management
The x_poll_metrics action runs every 15 minutes and:
- Fetches latest tweet metrics (views, likes, retweets, replies)
- Checks for new notifications
- For new reply/mention notifications, invokes the
comment-replyagent - The agent drafts a reply and presents it to the user
- User reviews and approves/edits before posting
Brand Voice Memory File
The brand voice file (memory/x-{username}-brand-voice.md) contains:
- Voice & tone analysis
- Common topics and themes
- Writing style patterns
- Engagement metrics insights
- Language preferences
- Content format preferences
- Key phrases and expressions
All agents load this file before creating content or replies.
OpenCLI Twitter Commands Reference
The app wraps opencli twitter which provides:
profile [username]— user profile infotweets <username>— recent tweetsnotifications— notification feedpost <text>— post a tweetreply <url> <text>— reply to a tweettimeline— home timelinesearch <query>— search tweetsthread <tweet-id>— get a full threadfollowers [user]— follower listfollowing [user]— following listtrending— trending topicslikes [user]— liked tweetsbookmarks— saved bookmarks
Metrics Storage
Poll results are stored in ~/.rome/default/apps/data/x/:
last-poll.json— last poll state (notification IDs to avoid dupes)metrics-log.jsonl— append-only log of all polled metrics over time