x-twitter

X (Twitter) API v2 skill using the authenticated user's own developer credentials (OAuth 1.0a, pay-per-use). All commands go through a single entry point: node <base_directory>/x.js <command> [flags]. Each command has its own doc file with the full reference for flags and behavior.

[!SETUP] Before first use, check whether <base_directory>/node_modules exists. If it does NOT exist, run npm install --prefix <base_directory>. Then check whether <base_directory>/dist/x.js exists. If it does NOT exist, run npm run build --prefix <base_directory>. NEVER cd into the skill directory; use --prefix to target it without changing your working directory.

[!COMMANDS]

Core: a) me — authenticated user's own account data (profile, metrics, verification). @docs/me.md. b) search — search posts by query. IMPORTANT: by default searches only the last 7 days; use --all (requires X_API_BEARER_TOKEN) for full archive. Do NOT use search with conversation_id: to read threads — use thread instead. @docs/search.md. c) get — retrieve one or more posts by ID. @docs/get.md. d) post — create a tweet, reply, or quote tweet. @docs/post.md. e) delete — delete a post owned by the authenticated user. @docs/delete.md. f) thread — retrieve a full thread/conversation given any tweet ID. Auto-resolves the conversation, paginates, and returns all tweets sorted chronologically. Use --all for threads older than 7 days. @docs/thread.md.

Engagement: g) like — like a post by tweet ID. @docs/like.md. h) unlike — remove a like from a post. @docs/like.md. i) repost — repost (retweet) a post. @docs/repost.md. j) unrepost — remove a repost. @docs/repost.md.