xAI Grok Integration with Agentic Tool Calling

When to Use This Skill

• User explicitly asks to use Grok or xAI
• User needs real-time X (Twitter) search - finding tweets, users, trends
• User requests "another opinion" or "alternative perspective"
• Query requires very recent information or current events
• User wants social media analysis or Twitter/X insights
• Task benefits from Grok's unique training and perspective
• Complex research requiring multiple tools (web search + code + Twitter)

Core Capabilities

1. X (Twitter) Search

• Semantic and keyword search across X posts, users, and threads
• User search by name or handle
• Thread fetching for full conversation context
• Real-time data from the X platform

2. Web Search

• Real-time search across the internet
• Browse web pages and extract content

3. Code Execution

• Write and execute Python code
• Data analysis and complex computations
• Generate visualizations and process data

4. Agentic Orchestration

• Server-side tool calling - Grok autonomously decides which tools to use
• Multi-step reasoning - Combines multiple tools to answer complex queries
• Streaming mode - Real-time progress and observability (always used per xAI recommendation)
• Citations - Full traceability of information sources

Usage

.claude/skills/xai-grok/src/grok.py

Basic Usage (X Search + Web Search enabled by default)

python3 grok.py "Find recent tweets from Israeli tech nano-influencers"

With All Tools Including Code Execution

python3 grok.py "Analyze tech trends with charts" --enable-code-execution

Get Help

python grok.py --help

Twitter/X Search Examples

# Find specific users
python3 grok.py "Who are the top Israeli tech influencers on X?"

# Search for recent tweets
python3 grok.py "Latest tweets about Israeli startups"

# Analyze trends
python3 grok.py "What are Israeli tech companies tweeting about today?"

# Use fast model with custom temperature (short options)
python3 grok.py "Recent AI tweets" -m grok-4-fast-reasoning -t 0.5

Disable Specific Tools

# Only X search, no web search
python3 grok.py "Find tweets" --disable-web-search

# Only web search, no X search
python3 grok.py "Latest news" --disable-x-search

# No tools (basic chat)
python3 grok.py "Explain AI" --disable-all-tools

Available Options

--model, -m              # Model selection (default: grok-4)
--temperature, -t        # Temperature for response generation (default: 0.3)
--disable-x-search       # Disable X (Twitter) search (enabled by default)
--disable-web-search     # Disable web search (enabled by default)
--enable-code-execution  # Enable Python code execution (opt-in)
--disable-all-tools      # Disable all tools (basic chat mode)
--show-citations         # Show source URLs (default: enabled)
--no-show-citations      # Hide source URLs
--show-usage             # Show token usage statistics
--show-tool-calls        # Show real-time tool calls
--install-completion     # Install shell completion for the current shell
--show-completion        # Show completion script for customization

Available Grok 4 Models

• grok-4

  - Highest quality model, 256k context [DEFAULT]

• grok-4-fast-reasoning

  - Cost-efficient with reasoning, 2M context

• grok-4-fast-non-reasoning

  - Cost-efficient without reasoning, 2M context

Requirements

• XAI_API_KEY environment variable in project's .env file

How It Works

1. Analyzes your query to understand what information is needed
2. Autonomously selects tools - decides whether to search X, browse web, execute code, or combine multiple approaches
3. Executes tools server-side - no need for you to handle tool responses
4. Iterates and refines - uses tool results to make better decisions
5. Returns comprehensive answer with citations and sources

• Search X for Israeli tech company tweets
• Search the web for global tech trends
• Execute Python code to analyze patterns
• Synthesize everything into a comprehensive answer

Output

• Streaming responses with real-time progress
• Citations - URLs of all sources Grok used
• Tool call visibility - See which tools Grok invoked (optional)
• Token usage - Detailed cost tracking (optional)
• Professional CLI - Rich formatted help text with boxed sections
• Shell completion - Tab completion support for all commands and options

Notes

• Typer-powered CLI provides a modern, user-friendly interface with rich formatting
• Grok responses are clearly indicated in output
• X search provides real-time data from the Twitter/X platform
• Citations show full traceability of information sources
• This is a supplementary tool; Claude remains the primary assistant
• API usage incurs costs on the user's xAI account
• Streaming mode is always used for agentic workflows (per xAI strong recommendation)
• Image/video understanding is not supported in this implementation