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:

Tool	When the model should call it
grok_ask	Text, review, planning, code
grok_imagine_image	Still images (image_gen / image_edit)
grok_imagine_video	Clips — 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