@stevederico/grok-cli

@stevederico/grok-cli

Grok CLI is an open-source interactive CLI tool that provides a flexible and powerful interface for AI-assisted workflows.

Supported Providers:

• XAI (Grok) - Cloud-based Grok models via xAI API
• OpenAI - GPT models via OpenAI API
• Anthropic - Claude models via Anthropic API
• Google Gemini - Gemini models via Google AI API
• OpenRouter - Multi-model routing service
• Groq - Fast open-source model inference
• Azure OpenAI - OpenAI models via Azure
• GitHub Models - Models via GitHub inference API
• Ollama - Local LLM inference with any Ollama model
• Custom - Any OpenAI-compatible endpoint

Quick Start

Install

npm i -g @stevederico/grok-cli

Using XAI (Grok)

export XAI_API_KEY="your_xai_api_key"
grok

Using OpenAI

export OPENAI_API_KEY="your_openai_api_key"
grok

Using Anthropic (Claude)

export ANTHROPIC_API_KEY="your_anthropic_api_key"
grok

Using Google Gemini

export GEMINI_API_KEY="your_gemini_api_key"
grok

Using Ollama

# Start Ollama service
ollama serve

# Pull a model (if needed)
ollama pull llama3.2:latest

# Run grok-cli with Ollama
export GROKCLI_PROVIDER=ollama
grok

Grok CLI auto-detects your provider based on which API key is set. To explicitly choose a provider, set GROKCLI_PROVIDER:

export GROKCLI_PROVIDER=anthropic
grok

Environment Variables

Provider Configuration

Provider	Environment Variable	Description
General	GROKCLI_PROVIDER	Choose provider: xai, openai, anthropic, google, openrouter, groq, azure, github, ollama, custom
XAI (Grok)	XAI_API_KEY	API key for xAI Grok models
XAI (Grok)	XAI_MODEL	Specific Grok model to use (default: grok-4-0709)
OpenAI	OPENAI_API_KEY	API key for OpenAI models
Anthropic	ANTHROPIC_API_KEY	API key for Anthropic Claude models
Google	GEMINI_API_KEY	API key for Google Gemini models
OpenRouter	OPENROUTER_API_KEY	API key for OpenRouter
Groq	GROQ_API_KEY	API key for Groq
Azure OpenAI	AZURE_OPENAI_API_KEY	API key for Azure OpenAI
Azure OpenAI	AZURE_OPENAI_ENDPOINT	Azure OpenAI endpoint URL
GitHub	GITHUB_TOKEN	GitHub token for GitHub Models
Custom	CUSTOM_API_KEY	API key for custom endpoint
Custom	CUSTOM_BASE_URL	Base URL for custom OpenAI-compatible endpoint
Ollama	GROKCLI_OLLAMA_ENDPOINT	Ollama service endpoint (default: http://localhost:11434)
Ollama	GROKCLI_OLLAMA_MODEL	Specific Ollama model to use (auto-detected)
Ollama	OLLAMA_HOST	Alternative Ollama endpoint (fallback)
Debug	DEBUG	Enable verbose logging

Provider Auto-Detection

When GROKCLI_PROVIDER is not set, Grok CLI auto-detects based on available API keys in this priority order:

xai > openai > anthropic > google > openrouter > groq > azure > github > custom > ollama

Examples

Once the CLI is running, you can start interacting with AI models from your shell.

Interactive Mode

Start a project from a new directory:

cd new-project
export XAI_API_KEY="your_key"
grok
> Write me a Discord bot that answers questions using a FAQ.md file I will provide

Work with an existing project using Ollama:

git clone https://github.com/stevederico/skateboard
cd skateboard
export GROKCLI_PROVIDER=ollama
grok
> Give me a summary of all of the changes that went in yesterday

Non-Interactive Mode

Ask a quick question with XAI:

export XAI_API_KEY="your_key"
grok -p "Explain what this code does" < main.js

Use Anthropic for code review:

export ANTHROPIC_API_KEY="your_key"
echo "Review this for bugs" | grok -p "analyze the code"

Next steps

• Contribute or build from source
• CLI Commands
• Troubleshooting guide
• Full documentation
• Popular tasks

Troubleshooting

Head over to the troubleshooting guide if you're having issues.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Terms of Service and Privacy Notice

For details on the terms of service and privacy notice applicable to your use of Grok CLI, see the Terms of Service and Privacy Notice.

Disclaimer

This project is not an official product or initiative of xAI or Grok. It is an independent endeavor and is not endorsed, sponsored, or affiliated with xAI or Grok in any way.