> grok cli

xAI's Grok models in a terminal agent — conversational file editing, bash execution, MCP tools, and headless mode, keyed by your xAI API key

getting started api keys and auth interactive session headless and scripting models and endpoints configuration mcp tools

// getting started

5 commands

Install Grok CLI globally

$ bun add -g @vibe-kit/grok-cli

Run Grok without installing it

$ npx @vibe-kit/grok-cli

Start an interactive session

Check the version or list every flag

$ grok --version

Build Grok CLI from source

$ git clone https://github.com/superagent-ai/grok-cli && cd grok-cli

// api keys and auth

4 commands

Set your Grok API key with an environment variable

$ export GROK_API_KEY=xai-your-key

Pass the API key as a command-line flag

$ grok --api-key xai-your-key

Load the API key from a .env file

$ cp .env.example .env

Store the API key in user settings

$ ~/.grok/user-settings.json

// interactive session

6 commands

Show the in-session help and command list

Clear the conversation history

Switch the model without leaving the session

Commit and push straight from the chat

$ /commit-and-push

Exit the interactive session

Navigate command and model suggestions

// headless and scripting

4 commands

Run a single prompt and exit

$ grok -p "show me the package.json file"

Limit how many tool rounds Grok runs

$ grok --max-tool-rounds 10 -p "show me the current directory"

Generate a commit message and push with AI

$ grok git commit-and-push

Automate Grok inside a CI pipeline

$ grok -p "review the staged diff and flag risky changes" -d . --max-tool-rounds 25

// models and endpoints

5 commands

Choose which model a run uses

$ grok -m grok-4-latest

Set your default model

$ ~/.grok/user-settings.json

Override the API base URL

$ grok --base-url https://api.x.ai/v1

Point Grok at an OpenAI-compatible provider

$ ~/.grok/user-settings.json

Run a non-Grok model like Claude or Gemini

$ grok --model gemini-2.5-pro --base-url https://your-endpoint.example.com/v1

// configuration

6 commands

Set global preferences in user-settings.json

$ ~/.grok/user-settings.json

Configure a single project with settings.json

$ .grok/settings.json

Give Grok project-specific instructions

$ .grok/GROK.md

Apply the same instructions across all projects

$ ~/.grok/GROK.md

Enable Morph Fast Apply for faster edits

$ export MORPH_API_KEY=your-morph-key

Control which edit tool Grok uses

$ grok -p "refactor this function to use async/await and add error handling"

// mcp tools

6 commands

Add a local stdio MCP server

$ grok mcp add my-server --transport stdio --command "bun" --args server.js

Add a remote HTTP MCP server

$ grok mcp add my-server --transport http --url "http://localhost:3000"

Add an SSE MCP server

$ grok mcp add linear --transport sse --url "https://mcp.linear.app/sse"

Add an MCP server from JSON

$ grok mcp add-json my-server '{"command": "bun", "args": ["server.js"], "env": {"API_KEY": "your-key"}}'

List, test, and remove MCP servers

$ grok mcp list

Define MCP servers in project settings

$ .grok/settings.json