grok-plugin-cc
Bring xAI's Grok Build CLI (grok) into Claude Code as a set of /grok:* slash commands plus a Grok-backed MCP server — for an outside-model second opinion and first-class live web/X search mid-task.
Unofficial. Not affiliated with or endorsed by xAI. "Grok" and "Grok Build" are xAI's.
License: MIT.
What it is
A personal, fully-local Claude Code plugin. It wraps headless grok -p --output-format json (no ACP, no daemon) and renders Grok's answers inline. Everything is plain .mjs with zero runtime dependencies and no build step, so it's trivial to fork and hand-edit.
/grok:ask — one-shot question to Grok, with live web/X search on by default (the headline feature)./grok:review — read-only review of your working tree or a branch diff, as an outside model./grok:status · /grok:result · /grok:cancel — lightweight control for background jobs./grok:setup — doctor: checks the CLI, auth, and resolved config.- MCP tools —
grok_search and grok_ask, so Claude can consult Grok (especially live search) on its own mid-task.
Install
1. Install Grok Build and authenticate:
curl -fsSL https://x.ai/cli/install.sh | bash
Then authenticate — either set XAI_API_KEY, or sign in (SuperGrok / X Premium+). The plugin needs Node 18+ (developed against Node 22).
2. Install the plugin from GitHub:
/plugin marketplace add trevoraspencer/grok-plugin-cc
/plugin install grok@grok-plugin-cc
Or, to fork and hand-edit, clone first and add the local path:
git clone https://github.com/trevoraspencer/grok-plugin-cc
/plugin marketplace add ./grok-plugin-cc
/plugin install grok@grok-plugin-cc
For a one-session try without installing (from a local clone):
claude --plugin-dir ./grok-plugin-cc
(There is no bare /plugin install <path> — use the marketplace add + install pair, or the one-session --plugin-dir flag.)
Run /grok:setup to confirm everything is wired up.
Command reference
| Command | What it does | Key flags |
|---|
/grok:ask <question> | Ask Grok one-shot; live search on by default | --model <slug>, --no-search, --search, --background |
/grok:review | Read-only review of the diff | --base <ref>, --scope auto|working-tree|branch, --background |
/grok:status [job-id] | List background jobs, or one job's detail | — |
/grok:result <job-id> | Print a finished job's captured output | — |
/grok:cancel <job-id> | Cancel a running background job | — |
/grok:setup | Diagnose CLI, auth, and resolved config | --json |
/grok:review is strictly read-only — it never edits files or applies patches.
Review scope (--scope, default auto):
auto — the working tree if it has uncommitted changes; otherwise a branch diff against the detected default branch (main / master / trunk / origin/HEAD).working-tree — always the uncommitted changes (staged + unstaged + untracked).branch — a branch diff; pass --base <ref> to pick the base, otherwise the default branch is detected.
An empty diff prints Nothing to review. and exits 0. A --base ref that doesn't exist — or --scope branch when no base can be detected — is reported as an error (exit 1) rather than a misleading "nothing to review".
MCP tools
The plugin ships a zero-dependency stdio MCP server (.mcp.json → scripts/mcp-server.mjs) exposing:
grok_search — { query, model? } → always performs a live web/X search and returns a synthesized answer with inline [[n]](url) citations.grok_ask — { prompt, model?, search? } → a one-shot question. Live search follows the web_search config default; pass search:true/false to override per call.
Claude can call these autonomously when it needs current information.
Configuration
Version-controlled defaults live in config/defaults.json. A machine-local override may be placed at ./.grok/grok-plugin.json (shallow-merged, git-ignored).
| Key | Default | Meaning |
|---|
default_model | grok-composer-2.5-fast | model for review and general use |
search_model | grok-build | model for ask / grok_search (searches reliably) |
fallback_model | grok-build | used if a chosen slug is empty |
safety | permissive | trust + git as the safety net (MVP commands are read-only). The write-capable rescue is phase-2; this key lets a future release flip to preview/approval without a rewrite. |
web_search | true | live-search default for /grok:ask and the grok_ask MCP tool (the grok_search tool always searches, regardless of this) |
max_turns | null | cap on grok agent turns for ask and the MCP tools; null = no cap |
