Skip to content

Claude Code Host

@ask-llm/plugin is the canonical multi-host package. This page covers its Claude Code marketplace adapter. For the Cursor-adapted pair skills (/codex-pair, /grok-pair) through Cursor Agent Skills/MCP, see Cursor Agent Host; for native Pi tools and lifecycle events, see Pi Host Support.

The Ask LLM plugin brings the second opinion into Claude Code itself: slash-command reviews (/codex-review, /multi-review), multi-model brainstorming (/brainstorm), and an opt-in continuous review hook (codex-pair) that checks every edit as you make it. Under the hood it adds review skills, brainstorm agents, and automated hooks.

Installation

Add the Ask LLM marketplace, then install the plugin:

bash
/plugin marketplace add Lykhoyda/ask-llm
/plugin install ask-llm@ask-llm-plugins

From Source (development)

bash
git clone https://github.com/Lykhoyda/ask-llm.git
cd ask-llm
yarn install && yarn build
claude --plugin-dir ./packages/claude-plugin

MCP Servers

The plugin ships only the Codex MCP registration used by review and pairing commands. Fully restart Claude Code after installation or upgrade, then run /mcp; plugin:ask-llm:codex should be connected and expose the exact ask-codex capability.

/grok-pair relies on user-scoped servers instead of plugin bundling. Install the unified Ask LLM server (recommended: it exposes model-neutral ask-cursor-agent and the unified ask-llm tool, which pair skills call only with provider, harness, exact model, and effort pinned) and, optionally, the split Grok server for the ask-grok leaf:

bash
claude mcp add --scope user ask-llm -- npx -y @ask-llm/mcp
claude mcp add --scope user grok -- npx -y @ask-llm/grok-mcp

Existing user-scoped Codex registrations remain supported if you prefer the shorter codex:ask-codex name. Register the other provider servers at user scope:

bash
claude mcp add --scope user antigravity -- npx -y @ask-llm/antigravity-mcp
claude mcp add --scope user ollama -- npx -y @ask-llm/ollama-mcp
claude mcp add --scope user gemini -- npx -y @ask-llm/gemini-mcp

If Codex registration is missing, provision it explicitly with claude mcp add --scope user codex -- npx -y @ask-llm/codex-mcp. If /mcp lists the server but it is disconnected, run npx -y @ask-llm/mcp doctor and fully restart Claude Code. /sol-review preserves source-plugin and session-local MCP/settings context when reading the active claude mcp list inventory, treats failed health or an MCP transport failure as unavailable, and discloses the explicit codex exec fallback.

What's Included

Skills (Slash Commands)

CommandProviderDescription
/multi-reviewAntigravity + CodexParallel review with 4-phase validation pipeline and consensus highlighting
/gemini-reviewGeminiGet a second opinion on your current changes
/codex-reviewCodexGet a second opinion from GPT-5.6 Sol
/fable-reviewFableNative isolated review, pinned to Fable
/sol-reviewGPT-5.6 SolModel-pinned review through Codex
/grok-reviewGrokExplicit xAI API or Grok CLI review; metered/plan-aware, no harness or model fallback
/grok-pairGrokConsent-gated iterative reviewer through exact Cursor Agent, xAI API, or Grok CLI route; no fallback
/codex-pairCodexContinuous Claude hook dashboard; Cursor uses the separate on-demand persisted-session adapter
/ollama-reviewOllamaLocal review, no data leaves your machine
/antigravity-reviewAntigravitySubscription-backed second opinion via Google agy (experimental)
/brainstormExplicit panel + Claude Opus evidenceSupports exact provider/harness/model routes, including a no-Gemini Grok + GPT-5.6 Sol panel through Cursor Agent; partial failures never become consensus
/brainstorm-allAll + Claude OpusBrainstorm with all five external providers (Gemini, Codex, Grok, Ollama, Antigravity) plus Claude Opus research
/compareMulti (configurable)Side-by-side raw responses from selected providers: no synthesis, no consensus extraction. Use when you want to see how each provider phrases the same answer

/codex-review and /sol-review require an installed, authenticated Codex CLI; the plugin supplies their MCP registration. /grok-review, /ollama-review, /antigravity-review, and bare-provider /brainstorm routes require their respective configured tools and credentials. Routed /brainstorm ...@cursor-agent:<exact-id> participants use the packaged model-neutral Cursor runner and require an authenticated Cursor Agent CLI; they do not silently use provider MCP tools as fallback.

Looking for continuous background review (not a slash command)? See codex-pair, a PostToolUse hook that runs Codex against every file edit when a project has opted in via a marker file. It's the recall-first complement to /codex-review.

Agents

AgentDescription
gemini-reviewerIsolated Gemini code review with confidence-based filtering
codex-reviewerIsolated Codex code review with confidence-based filtering
fable-reviewerNative read-only Fable review with source validation
sol-reviewerGPT-5.6 Sol review through Codex with source validation
grok-reviewerGrok review through the selected API/CLI harness with source validation and no fallback
ollama-reviewerLocal Ollama code review, no data leaves your machine
antigravity-reviewerSubscription-backed Antigravity (agy) code review, experimental
brainstorm-coordinatorResearches before dispatch, then synthesizes explicit participants. In exact Grok + Sol mode Claude is a non-voting verifier and two-model consensus requires both requested models to succeed.

Hooks

HookTriggerAction
codex-pair PostToolUseAfter every Edit/Write/MultiEditOpt-in. Self-gates on .codex-pair/context.md marker file. Zero cost without the marker. With marker: edits are debounced into a settle window, a detached worker reviews the settled file state, and HIGH/MED verdicts surface to Claude on a later edit, the next user prompt, or at turn end. See Codex Pair for opt-in steps and cost characteristics
codex-pair-prompt-drain UserPromptSubmitOn every user promptDrains queued codex-pair verdicts that finished mid-turn so they reach Claude without waiting for the next edit
codex-pair-stop-gate StopAt turn endDrains remaining queued verdicts (no opt-in needed). With blockOn: HIGH in the marker frontmatter (opt-in, default OFF), blocks turn-end while unaddressed HIGH findings or in-flight reviews remain
codex-pair-session SessionStart / SessionEndAt Claude session boundarySessionStart announces a paused project or auto-resumes an expired auto-pause; SessionEnd clears debounce state so orphaned workers self-cancel. Lifecycle for the experimental codex app-server broker additionally runs only with ASK_CODEX_BROKER=1

The hook shells out directly to codex exec --json with zero workspace imports, required so it runs from marketplace git-subdir installs that don't run npm install. A previous PreToolUse Gemini-review pre-commit hook was removed because continuous codex-pair review covers the same need with higher recall; use /gemini-review or /codex-review on demand for explicit pre-commit review instead.

CLI Binaries (source builds only)

These commands are available after cloning and building the plugin locally. Marketplace git-subdir installs do not build or ship the generated dist/ binaries.

CommandDescription
ask-gemini-runPipe code or prompts directly to Gemini CLI
ask-codex-runPipe code or prompts directly to Codex CLI
ask-grok-runPipe code or prompts to the explicitly configured Grok API/CLI harness
ask-brainstorm-runRun the exact Grok + GPT-5.6 Sol panel with repeated provider@harness:exact-model-id participant specs and structured partial-failure output
ask-ollama-runPipe code or prompts directly to local Ollama

How It Works

The plugin uses several Claude Code integration points:

  1. plugin.json + .mcp.json: Explicitly declares the Codex MCP component for Claude Code plugin sessions (see Installation); Cursor/Grok routes use user-scoped @ask-llm/mcp and @ask-llm/grok-mcp registrations, and the separate .cursor-plugin/plugin.json + unified-only mcp.json adapter uses Cursor's supported surfaces
  2. Skills (skills/): User-invocable slash commands that trigger review or brainstorm workflows
  3. Agents (agents/): Handle the actual interaction with each provider using confidence-based filtering (80%+ threshold). Agents read CLAUDE.md for project conventions when available.
  4. Hooks (hooks/): Run the opt-in codex-pair continuous review pipeline: per-edit PostToolUse reviews, verdict drains on user prompts and at turn end, the opt-in Stop gate, and session lifecycle
  5. Source-build CLI binaries (src/): After a local build/link, enable piped analysis from shell: git diff | ask-gemini-run "review this"

Requirements

  • Claude Code installed and authenticated
  • Codex CLI authenticated, required for /codex-review and brainstorm with Codex
  • Ollama running locally, required for /ollama-review and brainstorm with Ollama
  • Gemini CLI authenticated (gemini login), required for Gemini features
  • For /brainstorm, at least two providers should be available for meaningful synthesis

Source

  • Pi: pi install npm:@ask-llm/plugin (guide)
  • Marketplace: /plugin marketplace add Lykhoyda/ask-llm then /plugin install ask-llm@ask-llm-plugins
  • Source: packages/claude-plugin

Released under the MIT License.