twitter-skill

Twitter Skill

A Claude Code plugin for full Twitter/X API integration with OAuth 2.0 PKCE authentication.

Features

• OAuth 2.0 PKCE Authentication with 1Password CLI support
• Tweet Operations: Post, delete, read tweets and timeline
• Engagement: Like, unlike, retweet, unretweet
• Search: Search recent tweets
• List Management: Create, delete, manage list members
• Rate Limit Tracking: Real-time visibility into API limits

Quick Start

# Install dependencies
pnpm install

# Set up credentials (supports 1Password or manual entry)
pnpm tsx scripts/twitter.ts setup

# Authenticate with Twitter
pnpm tsx scripts/twitter.ts auth

# Get your profile
pnpm tsx scripts/twitter.ts me

Commands

Setup & Authentication

setup                             # Configure API credentials
auth                              # Run OAuth flow
check                             # Verify authentication status

User

me [--email]                      # Get authenticated user info
user                    # Get user by username
user-id                       # Get user by ID
users                # Get multiple users by IDs (max 100)

Tweets

post "text"                       # Post a tweet
delete                        # Delete a tweet
tweet                         # Get a single tweet
tweets                            # Get my recent tweets
timeline                          # Get home timeline

Engagement

like                          # Like a tweet
unlike                        # Unlike a tweet
retweet                       # Retweet
unretweet                     # Undo retweet

Search

search "query"                    # Search tweets

Lists

lists                             # Get my lists
list                          # Get list details
list-members                  # Get members of a list

...