Otherdsh-plugin

dsh-llm-grok

A DeepSeek Harness plugin that adds a Grok subscription provider route and settings namespace, using an xAI PKCE sign-in flow that keeps sessions on the Host. It also contributes a Grok card to the LLM Providers settings page owned by dsh-llm-providers-ui, plus chat, usage, search, and optional image generation.

Stars
1
Forks
1
Open issues
4
Last push
Sep 24, 2026
Latest release
v0.3.19
24h Growth
+0
7d Growth
+0

Installation

dsh plugin --profile web add --force \

Overview

A DeepSeek Harness plugin that adds a Grok subscription provider route and settings namespace, using an xAI PKCE sign-in flow that keeps sessions on the Host. It also contributes a Grok card to the LLM Providers settings page owned by dsh-llm-providers-ui, plus chat, usage, search, and optional image generation.

  • Separate `grok` provider route and `llm-grok` settings namespace; does not replace the built-in `xai` console API-key route
  • Sign in with xAI starts a Host-owned PKCE flow against auth.x.ai and stores the session at $DSH_HOME/grok-oauth.json (mode 0600)
  • Browser never receives tokens; sign out deletes the stored session file
  • Chat uses POST https://cli-chat-proxy.grok.com/v1/responses with DSH function tools plus server-side web_search and x_search
  • Model catalog read from GET /v1/models-v2; displayed subset stored as settings.models with default thinking and context window
  • Signed-in card shows subscription usage from a Host billing read of GET /v1/billing?format=credits
  • Optional grok_image_gen tool (default off) generates images with Grok Imagine via api.x.ai/v1/images/generations
  • Configurable streamIdleTimeoutMs and retryPolicy, with up to eight retries by default for eligible failures

Related plugins