clix

Category: Ops & Delivery | Uploader: spideystreet | Downloads: 0 | Version: v1.0（Latest）

Interact with Twitter/X from the terminal — read timelines, search, post, like, retweet, bookmark. Use when user asks to check Twitter, post tweets, monitor accounts, search X, or manage bookmarks.

Changelog: Source: GitHub https://github.com/spideystreet/clix

Directory Structure

Current level: Root

📁 .claude/
- 📁 rules/
  - 📄 coding.md 1.5 KB
📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.yml 1.1 KB
  - 📄 feature_request.yml 562 B
- 📁 workflows/
  - 📄 ci.yml 544 B
  - 📄 release.yml 858 B
- 📄 pull_request_template.md 260 B
📁 clix/
- 📁 cli/
  - 📄 __init__.py 0 B
  - 📄 app.py 12.3 KB
  - 📄 feed.py 1.9 KB
  - 📄 helpers.py 1.2 KB
  - 📄 search.py 1.5 KB
  - 📄 tweet.py 1.4 KB
  - 📄 user.py 4.8 KB
- 📁 core/
  - 📄 __init__.py 0 B
  - 📄 api.py 13.1 KB
  - 📄 auth.py 8.6 KB
  - 📄 client.py 9.9 KB
  - 📄 config.py 2.9 KB
  - 📄 constants.py 3.7 KB
  - 📄 endpoints.py 15.6 KB
- 📁 display/
  - 📄 __init__.py 0 B
  - 📄 formatter.py 8.3 KB
- 📁 mcp/
  - 📄 __init__.py 0 B
  - 📄 server.py 7.8 KB
- 📁 models/
  - 📄 __init__.py 0 B
  - 📄 tweet.py 5.7 KB
  - 📄 user.py 2.7 KB
- 📁 utils/
  - 📄 __init__.py 0 B
  - 📄 filter.py 1.3 KB
  - 📄 rate_limit.py 865 B
- 📄 __init__.py 75 B
- 📄 __main__.py 83 B
📁 tests/
- 📄 __init__.py 0 B
- 📄 test_api.py 8.9 KB
- 📄 test_auth.py 3.4 KB
- 📄 test_cli.py 1.4 KB
- 📄 test_config.py 1.0 KB
- 📄 test_constants.py 593 B
- 📄 test_endpoints.py 14.6 KB
- 📄 test_filter.py 2.3 KB
- 📄 test_mcp.py 2.9 KB
- 📄 test_models.py 7.0 KB
📄 .gitignore 4.7 KB
📄 CHANGELOG.md 1.6 KB
📄 CLAUDE.md 4.0 KB
📄 CONTRIBUTING.md 1.4 KB
📄 LICENSE 1.0 KB
📄 pyproject.toml 1.4 KB
📄 README.md 3.1 KB
📄 SKILL.md 4.7 KB
📄 uv.lock 159.7 KB

SKILL.md

---
name: clix
description: "Interact with Twitter/X from the terminal — read timelines, search, post, like, retweet, bookmark. Use when user asks to check Twitter, post tweets, monitor accounts, search X, or manage bookmarks."
---

# clix — Twitter/X CLI Skill

A CLI tool for Twitter/X using cookie-based authentication (no API keys needed).

## Setup

```bash
# Install (if not already)
cd /path/to/clix && uv sync

# Authenticate (one of these methods):
clix auth login                           # Extract cookies from browser
clix auth set --token TOKEN --ct0 CT0     # Manual cookie entry
export X_AUTH_TOKEN=xxx X_CT0=xxx      # Environment variables
```

## Commands Reference

### Reading

```bash
# Timeline
clix feed                                # For-you timeline
clix feed --type following               # Following timeline
clix feed --count 50                     # More tweets
clix feed --filter top --top 5           # Top 5 by engagement

# Search
clix search "query"                      # Search (Top results)
clix search "query" --type Latest        # Latest results
clix search "from:user topic"           # Search from specific user

# Tweets
clix tweet TWEET_ID                      # View single tweet
clix tweet TWEET_ID --thread             # View full thread

# Users
clix user handle                         # User profile
clix user tweets handle                  # User's tweets
clix user likes handle                   # User's likes
clix user followers handle               # User's followers
clix user following handle               # Who user follows

# Bookmarks
clix bookmarks                           # View your bookmarks
```

### Writing

```bash
clix post "Hello world"                  # Post a tweet
clix post "reply text" --reply-to ID     # Reply to tweet
clix post "quote" --quote URL            # Quote tweet
clix delete TWEET_ID --force             # Delete (--force skips confirm)
clix like TWEET_ID                       # Like a tweet
clix unlike TWEET_ID                     # Unlike
clix retweet TWEET_ID                    # Retweet
clix unretweet TWEET_ID                  # Undo retweet
clix bookmark TWEET_ID                   # Bookmark
clix unbookmark TWEET_ID                 # Remove bookmark
```

### Account Management

```bash
clix auth status                         # Check auth status
clix auth login                          # Extract browser cookies
clix auth login --browser chrome         # Specific browser
clix auth set --token T --ct0 C          # Manual credentials
clix auth accounts                       # List stored accounts
clix auth switch ACCOUNT_NAME            # Switch default account
```

## JSON Output (Agent Mode)

**All commands support `--json` for structured output.** Output is auto-JSON when stdout is not a TTY (piped).

```bash
clix feed --json                         # JSON array of tweets
clix search "query" --json               # JSON search results
clix user handle --json                  # JSON user profile
clix auth status --json                  # JSON auth check
```

### JSON Tweet Schema

```json
{
  "id": "1234567890",
  "text": "Tweet content",
  "author_handle": "username",
  "author_name": "Display Name",
  "author_verified": true,
  "created_at": "2024-01-01T00:00:00Z",
  "engagement": {
    "likes": 100,
    "retweets": 50,
    "replies": 10,
    "views": 5000,
    "bookmarks": 5,
    "quotes": 2
  },
  "media": [{"type": "photo", "url": "..."}],
  "reply_to_id": null,
  "tweet_url": "https://x.com/username/status/1234567890"
}
```

## Best Practices for Agents

1. **Always use `--json`** for parseable output
2. **Use `--force`** on `delete` to skip interactive confirmation
3. **Respect rate limits** — add delays between bulk operations
4. **Use `--count`** to limit results (default: 20, max: 100)
5. **Use `--pages`** for pagination (feed/search only)
6. **Check auth first** with `clix auth status --json` before operations
7. **Use `--account`** for multi-account workflows

## Exit Codes

| Code | Meaning |
|------|---------|
| 0 | Success |
| 1 | General error |
| 2 | Authentication error |
| 3 | Rate limit exceeded |

## Rate Limiting

- Read operations have ~1.5s built-in delay between requests
- Write operations have 1.5-4s random delay
- Exponential backoff on 429 responses
- For bulk operations, add your own delays between calls

## MCP Server

clix is also available as an MCP server with 14 tools for any MCP-compatible client.

```bash
clix mcp    # Start stdio MCP server
```

Configure in your MCP client:

```json
{
  "mcpServers": {
    "clix": {
      "command": "uvx",
      "args": ["clix0", "mcp"]
    }
  }
}
```

## Proxy Support

```bash
export X_PROXY=socks5://host:port     # SOCKS5 proxy
export X_PROXY=http://host:port       # HTTP proxy
```

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

clix

Directory Structure

SKILL.md

Report

Notice