bird-twitter

# Bird Twitter Skill 🐦

Fast Twitter/X CLI wrapper using `bird` — post tweets, reply, read, search, and manage your timeline via Twitter's GraphQL API.

## Required Environment Variables

```bash
export AUTH_TOKEN=<your_twitter_auth_token>
export CT0=<your_twitter_ct0_cookie>
```

### How to Get Tokens

1. Log in to Twitter/X in your browser
2. Open Developer Tools (F12)
3. Go to Application/Storage → Cookies → twitter.com
4. Copy:
   - `auth_token` → `AUTH_TOKEN`
   - `ct0` → `CT0`

## Quick Usage

```bash
# Check login status
bird whoami

# Check credential availability
bird check

# Post a tweet
bird tweet "Hello from bird-twitter skill!"

# Reply to a tweet
bird reply <tweet-id-or-url> "Great thread!"

# Read a tweet
bird read <tweet-id-or-url>

# Read with JSON output
bird read <tweet-id-or-url> --json

# Search tweets
bird search "query"

# Get home timeline
bird home

# Get mentions
bird mentions

# Get liked tweets
bird likes

# Follow a user
bird follow <username>

# Get user's tweets
bird user-tweets <handle>

# Get trending topics
bird news
bird trending
```

## Commands

### Posting

| Command | Description |
|---------|-------------|
| `bird tweet <text>` | Post a new tweet |
| `bird reply <url> <text>` | Reply to a tweet |
| `bird tweet <text> --media <path>` | Tweet with media (up to 4 images or 1 video) |

### Reading

| Command | Description |
|---------|-------------|
| `bird read <url>` | Read/fetch a tweet |
| `bird thread <url>` | Show full conversation thread |
| `bird replies <url>` | List replies to a tweet |
| `bird user-tweets <handle>` | Get user's tweets |

### Timelines

| Command | Description |
|---------|-------------|
| `bird home` | Home timeline ("For You" feed) |
| `bird mentions` | Tweets mentioning you |
| `bird likes` | Your liked tweets |
| `bird bookmarks` | Your bookmarked tweets |

### Search & Discovery

| Command | Description |
|---------|-------------|
| `bird search <query>` | Search tweets |
| `bird news` | AI-curate...