@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.