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 <username>                   # Get user by username
user-id <id>                      # Get user by ID
users <id1,id2,...>               # Get multiple users by IDs (max 100)

Tweets

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

Engagement

like <id>                         # Like a tweet
unlike <id>                       # Unlike a tweet
retweet <id>                      # Retweet
unretweet <id>                    # Undo retweet

Search

search "query"                    # Search tweets

Lists

lists                             # Get my lists
list <id>                         # Get list details
list-members <id>                 # Get members of a list
list-add <list-id> <user-id>      # Add user to list
list-remove <list-id> <user-id>   # Remove user from list
list-create "name" [--private]    # Create a new list
list-delete <id>                  # Delete a list

Rate Limit Tracking

Every API call logs rate limit status:

[rate-limit] /users/me: 1199997/1200000, resets in 13m
[rate-limit] /lists/.../members: 2/5 (low), resets in 14m
[rate-limit] /tweets: 0/50 (CRITICAL), resets in 5m

Credential Setup

Option 1: 1Password (Recommended)

If you have 1Password CLI installed, credentials are loaded from:

• op://Development/Twitter Client ID/notesPlain
• op://Development/Twitter Client Secret/notesPlain

Option 2: Manual Configuration

Create ~/.config/twitter-skill/credentials.json:

{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}

Token Storage

Tokens are stored per-project at .claude/twitter-skill.local.json, allowing different projects to use different Twitter accounts.

As a Claude Code Plugin

Add to your Claude Code plugins to use Twitter from any project:

# From Claude Code
/twitter post "Hello from Claude Code!"
/twitter timeline
/twitter lists

License

MIT