--- name: xint-rs description: > Fast X Intelligence CLI (Rust) — search, analyze, and engage on X/Twitter from the terminal. Use when: (1) user says "x research", "search x for", "search twitter for", "what are people saying about", "what's twitter saying", "check x for", "x search", "search x", (2) user wants real-time monitoring with "watch", (3) user needs AI-powered analysis with Grok ("analyze", "sentiment"), (4) user needs intelligence reports ("report"), (5) user wants to track followers ("diff"), (6) user needs trending topics ("trends"). Also supports: bookmarks, likes, following (OAuth), x-search, collections, CSV/JSON/JSONL export. Non-goals: Not for posting tweets, not for DMs, not for enterprise features. credentials: - name: X_BEARER_TOKEN description: X API v2 bearer token for search, profile, thread, tweet, trends required: true - name: XAI_API_KEY description: xAI API key for Grok analysis, article fetching, sentiment, x-search, collections required: false - name: XAI_MANAGEMENT_API_KEY description: xAI Management API key for collections management required: false - name: X_CLIENT_ID description: X OAuth 2.0 client ID for user-context operations (bookmarks, likes, following, diff) required: false required_env_vars: - X_BEARER_TOKEN requiredEnvVars: - X_BEARER_TOKEN primary_credential: X_BEARER_TOKEN primaryCredential: X_BEARER_TOKEN security: always: false autonomous: false local_data_dir: data/ network_endpoints: - https://api.x.com - https://x.com - https://api.x.ai ---

xint — X Intelligence CLI (Rust)

Fast, zero-dependency binary for X/Twitter search, analysis, and engagement from the terminal. All output goes to stdout (pipe-friendly).

Security Considerations

This skill requires sensitive credentials. Follow these guidelines:

Credentials

• X_BEARER_TOKEN: Required for X API. Treat as a secret - only set in environment or .env file
• XAI_API_KEY: Optional, needed for AI analysis. Also a secret
• X_CLIENT_ID: Optional, needed for OAuth. Less sensitive but don't expose publicly
• XAI_MANAGEMENT_API_KEY: Optional, for collections management

File Writes

• This skill writes to its own data/ directory: cache, exports, snapshots, OAuth tokens
• OAuth tokens stored with restrictive permissions (chmod 600)
• Review exported data before sharing - may contain sensitive search queries

Webhooks

• The watch command supports --webhook to send data to external URLs
• Only use webhooks you control (your own servers, Slack/Discord you own)
• Don't pass sensitive URLs as webhook targets

Agent Execution Boundaries

• This file documents commands and safety limits only
• Require explicit user approval before install/clone actions
• Use only documented commands and flags
• Require explicit user approval before network-facing modes (mcp --sse, watch --webhook)

Installation

• For required tools: prefer OS package managers over curl | bash when possible
• Verify any installer scripts before running

MCP Server (Optional)

• xint mcp starts a local MCP server exposing xint commands as tools
• Default mode is stdio/local integration; no inbound web server unless --sse is explicitly enabled
• Respect --policy read_only|engagement|moderation and budget guardrails

Setup

Requires env vars (in .env or exported):

• X_BEARER_TOKEN — for search, profile, tweet, thread, trends, watch, report
• X_CLIENT_ID — for OAuth commands (bookmarks, likes, following, diff)
• XAI_API_KEY — for AI analysis (analyze, report, x-search, collections upload/search)
• XAI_MANAGEMENT_API_KEY — for collections management (list, create, ensure, add-document)

OAuth setup (one-time): xint auth setup

Commands

Search & Discovery

xint search "AI agents" --limit 10            # Search recent tweets
xint search "AI agents" --quick               # Fast mode (1 page, 10 max, 1hr cache)
xint search "AI agents" --quality             # Min 10 likes filter
xint search "AI agents" --since 1d --sort likes
xint search "from:elonmusk" --limit 5
xint search "AI agents" --json                # JSON output
xint search "AI agents" --jsonl               # One JSON per line
xint search "AI agents" --csv                 # CSV output
xint search "AI agents" --sentiment           # AI sentiment analysis (needs XAI_API_KEY)
xint search "AI agents" --save                # Save to data/exports/

Monitoring

xint watch "AI agents" -i 5m                  # Poll every 5 minutes
xint watch "@elonmusk" -i 30s                 # Watch user (auto-expands to from:)
xint watch "bitcoin" --webhook https://example.com/webhook  # POST new tweets to webhook
xint watch "topic" --jsonl                    # Machine-readable output

Profiles & Tweets

xint profile elonmusk                         # User profile + recent tweets
xint profile elonmusk --json                  # JSON output (includes connection_status, subscription_type)
xint tweet 1234567890                         # Fetch single tweet
xint thread 1234567890                        # Fetch conversation thread

Reposts (who reposted a tweet)

xint reposts <tweet_id>                       # List users who reposted
xint reposts <tweet_id> --limit 50            # Limit results
xint reposts <tweet_id> --json                # JSON output

User Search

xint users "AI researcher"                    # Find users by keyword
xint users "solana dev" --limit 10 --json     # JSON output with limit

Article Fetching (requires XAI_API_KEY)

Fetch and extract full article content from any URL using xAI's web_search tool. Also supports extracting linked articles from X tweets.

# Fetch article content
xint article "https://example.com"

# Fetch + analyze with AI
xint article "https://example.com" --ai "Summarize key takeaways"

# Auto-extract article from X tweet URL and analyze
xint article "https://x.com/user/status/123456789" --ai "What are the main points?"

# Full content without truncation
xint article "https://example.com" --full

# JSON output
xint article "https://example.com" --json

Trends

xint trends                                   # Worldwide trending
xint trends us                              # US trends
xint trends --json                          # JSON output
xint trends --locations                     # List supported locations

AI Analysis (requires XAI_API_KEY)

xint analyze "What's the sentiment around AI?"       # Default model: grok-4-1-fast
xint analyze --tweets saved.json              # Analyze tweets from file
cat tweets.json | xint analyze --pipe         # Analyze from stdin
xint analyze "question" --model grok-4        # Use specific model

Available models: grok-4, grok-4-1-fast (default), grok-3, grok-3-mini, grok-2

Intelligence Reports

xint report "AI agents"                       # Full report with AI summary
xint report "AI agents" -a @user1,@user2      # Track specific accounts
xint report "AI agents" -s                    # Include sentiment analysis
xint report "AI agents" --save                # Save to data/exports/

Follower Tracking (requires OAuth)

xint diff @username                           # Snapshot followers, diff vs previous
xint diff @username --following               # Track following instead
xint diff @username --history                 # Show snapshot history

...