Skip to main content

Installation & Setup Guide

title: Installation & Setup Guide ---# Installation & Setup Guide

Overview​

Grok CLI is installed globally via npm and includes automated installation scripts to handle common issues.

Installation Methods​

Use the provided install.sh script for automatic handling of installation issues:

curl -fsSL https://raw.githubusercontent.com/hinetapora/grok-cli-hurry-mode/main/install.sh | bash

The script automatically: - Detects and removes conflicting installations - Tries multiple installation methods (npm, yarn, pnpm) - Handles common npm cache and permission issues - Cleans up failed installations

Manual Installation​

If automated installation fails, try manual methods:

npm install -g grok-cli-hurry-mode@latest

Try Without Installing​

npx grok-cli-hurry-mode@latest

Alternative Package Managers​

# Yarn
yarn global add grok-cli-hurry-mode@latest

# pnpm
pnpm add -g grok-cli-hurry-mode@latest

# Bun
bun add -g grok-cli-hurry-mode@latest

Force Installation (if needed)​

npm install -g grok-cli-hurry-mode --force

Post-Installation Setup​

1. Verify Installation​

grok --version

2. Set API Key​

# Environment variable (recommended)
export GROK_API_KEY=your_api_key_here

# Save permanently to shell profile
echo 'export GROK_API_KEY=your_api_key_here' >> ~/.zshrc
source ~/.zshrc

# Or save permanently (bash users)
echo 'export GROK_API_KEY=your_api_key_here' >> ~/.bashrc
source ~/.bashrc

3. PATH Setup (If "command not found")​

# Add npm global bin to PATH (macOS/Linux)
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Verify it works
which grok
grok --version

3. Get Started​

grok --help

4. First Run​

grok

This launches the interactive chat interface.

Troubleshooting​

Common Installation Issues​

- Permission errors: Try with sudo or use a Node version manager - Cache issues: The install script automatically cleans npm cache - Stuck installations: Script kills running processes and removes old files

Manual Cleanup​

If needed, manually clean before reinstalling:

# Kill running processes
pkill -f grok

# Remove installation
npm uninstall -g grok-cli-hurry-mode

# Clean cache
npm cache clean --force

Alternative Installation​

Download pre-built binaries from: https://github.com/hinetapora/grok-cli-hurry-mode/releases

Requirements​

- Node.js (latest LTS recommended) - npm, yarn, or pnpm - Internet connection for API access