DeepSeek Harness plugin

dsh-llm-grok-oauth

Grok (xAI) subscription OAuth provider for DeepSeek Harness: one-click login in Settings → Models, token refresh, live catalog, streaming over cli-chat-proxy.grok.com

Jump to install

Source facts

Repository
wangyaominde/dsh-llm-grok-oauth
Latest update
Aug 16, 2026
Category
Plugin Markets & Managers
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/wangyaominde/dsh-llm-grok-oauth
Plugin: dsh-llm-grok-oauth
Author: wangyaominde

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

<p align="center"> <img src="docs/en/banner.jpg" alt="dsh-llm-grok-oauth" width="920"> </p>

<h1 align="center">dsh-llm-grok-oauth</h1>

<p align="center"> DeepSeek Harness plugin: sign in with a Grok account under Settings → Models<br> and run models on a SuperGrok / X Premium+ subscription. No xAI API key. </p>

<p align="center"> English · <a href="README.zh.md">简体中文</a> </p>

<p align="center"> <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-1f6feb?style=flat-square" alt="dsh-plugin"></a> <a href="https://github.com/wangyaominde/dsh-llm-grok-oauth/stargazers"><img src="https://img.shields.io/github/stars/wangyaominde/dsh-llm-grok-oauth?style=flat-square" alt="stars"></a> <a href="LICENSE"><img src="https://img.shields.io/github/license/wangyaominde/dsh-llm-grok-oauth?style=flat-square&label=license" alt="MIT"></a> <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/dsh-0.1.0--rc.6+-111827?style=flat-square" alt="dsh"></a> <img src="https://img.shields.io/badge/API%20Key-not%20required-2ea44f?style=flat-square" alt="no api key"> </p>

---

The built-in Grok provider in DSH accepts an API key only. This plugin adds account login on the same page. The control is at:

Settings → Models → Grok (xAI 订阅)

<p align="center"> <img src="docs/en/models-login.jpg" alt="Settings → Models → Grok (xAI subscription)" width="720"> </p>

Install

Requires DeepSeek Harness and pnpm. If dsh is not on PATH, use npx:

npx @deepseek-ai/dsh plugin --profile web add github:wangyaominde/dsh-llm-grok-oauth

If the dsh command is already installed:

dsh plugin --profile web add github:wangyaominde/dsh-llm-grok-oauth

Restart dsh web after installation. Client modules are loaded at process start; the login button will not appear until restart.

If pnpm warns about missing peers such as @deepseek-ai/cordis, ignore it. Those packages are provided by the DSH runtime and should not be installed into the plugin directory.

Usage

Open Settings → Models and click Sign in with Grok on Grok (xAI 订阅). Browser sign-in is the default. The official Grok CLI is not required.

1. Complete xAI authorization in the browser. The confirmation code is issued by xAI for that attempt; it is not shared across machines or clicks. 2. Return to a session and select a Grok model. If the current session still targets DeepSeek, start a new session before sending.

The DSH process must be able to reach https://auth.x.ai and https://cli-chat-proxy.grok.com. Sign-in, the model catalog, and chat share the same proxy stack (HTTPS_PROXY or the macOS system proxy). If a browser can open those hosts but sign-in or sending a message still fails, set the proxy in the environment that launches dsh web and retry.

If the official Grok CLI is already signed in, that session is reused silently. Machines without the CLI are not asked to run grok login.

Sign-out is on the same row. It clears this plugin's session immediately and does not delete the official Grok CLI login file. CLI reuse stays off until Sign in is clicked again. If an older build signs back in immediately after Sign out, or sign-in works but chat fails with TRANSPORT, update to 0.2.10 and fully restart dsh web.

Requirements

ItemRequirement
DeepSeek Harness0.1.0-rc.6 or later
AccountSuperGrok or X Premium+
Official Grok CLInot required. Reused only when already signed in
xAI API keynot required

Relation to the API key field

This pluginBuilt-in Grok config
LocationSettings → ModelsSettings → Models
AuthenticationGrok account loginAPI key
BillingSuperGrok / X Premium+xAI API credit

Both may be configured at the same time. This plugin does not write or overwrite a saved API key.

Uninstall

npx @deepseek-ai/dsh plugin --profile web remove dsh-llm-grok-oauth

Restart dsh web after uninstall.

License

[MIT](LICENSE)