deepseekplugins

DeepSeek Harness plugin

dsh-plugin-grok

DeepSeek Harness plugin: drive the local Grok Build CLI for text, image, and video.

Development & Runtime
Jump to install

Source facts

Repository
toolazytoname/dsh-plugin-grok
Latest update
Aug 17, 2026
Category
Development & Runtime
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/toolazytoname/dsh-plugin-grok
Plugin: dsh-plugin-grok
Author: toolazytoname

Check the source files

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

File explorer4 files
README.mdSource · read only
README language

dsh-plugin-grok

DeepSeek Harness plugin that drives your local Grok Build CLI — the same grok binary, whether you signed in with SuperGrok or exported an API key.

One worker, three jobs:

ToolWhen the model should call it
grok_askText, review, planning, code
grok_imagine_imageStill images (image_gen / image_edit)
grok_imagine_videoClips — still first, then image_to_video

It is not grok2api and does not call Imagine over raw HTTP. It only execs local grok. Auth is whichever Grok Build already accepts.

中文说明

Install

dsh plugin --profile web add github:toolazytoname/dsh-plugin-grok

Then restart dsh web and hard-refresh the browser.

If pnpm ≥ 10 blocks the git prepare script, allow the build once in that profile:

# in ~/.dsh/profiles/web/pnpm-workspace.yaml
allowBuilds:
  dsh-plugin-grok: true

Or install from a local checkout:

dsh plugin --profile web add /absolute/path/to/dsh-plugin-grok

Prerequisite

1. Install Grok Build so grok is on PATH (usually ~/.grok/bin/grok). 2. Provide one of these (same order the official CLI uses): - grok login — SuperGrok / grok.com session in ~/.grok/auth.json. This wins if both exist. - XAI_API_KEY — key from console.x.ai, for people who never log in. You can also put apiKey on the plugin row in cordis.yml; env is safer. 3. In mainland China, set https_proxy / HTTPS_PROXY (Clash mixed port, often http://127.0.0.1:7891). The plugin forwards those vars.

If you are logged in, a leftover XAI_API_KEY is unset on the child process so Imagine stays on the session pool instead of the API bill.

You do not need a live DSH session to develop or test this repo (npm test uses a stub grok).

What the model gets

  • grok_ask — grok --prompt-file … --always-approve with the full coding toolset.
  • grok_imagine_image — same CLI, tools restricted to image_gen,image_edit. Returns absolute image path(s).
  • grok_imagine_video — Grok has no text-to-video. The prompt tells Grok to stage a still, then call image_to_video. Returns absolute video path(s).

Missing grok, missing both login and XAI_API_KEY, empty prompt, non-zero exit, or a media run with no parseable path all fail closed.

CLI (optional)

npx dsh-plugin-grok status
npx dsh-plugin-grok ask "summarize this repo"
npx dsh-plugin-grok image "a red cube on a table" --ratio 1:1
npx dsh-plugin-grok video "slow cinematic push-in" --duration 6 --resolution 480p

Known limits

  • Login users spend SuperGrok / coding-plan quota. API-key users spend console credits. Image and video are slow either way; a key without Imagine access will fail closed.
  • Video is still-then-animate, not native text-to-video. Default 6s / 480p. Cap is 720p.
  • One local grok process per tool call. No ACP / grok agent stdio wrapper.
  • DeepSeek Harness is a developer preview; the Cordis apply + ctx.tools.register contract may drift.
  • This is the worker, not a kanban or budget butler.

Develop

npm install
npm run check

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category