DSH Grok Subscription

Bring your Grok subscription into DeepSeek Harness.

Paying for Grok but having it confined to the Grok Build CLI makes multi-agent work awkward: tasks, context, and generated media have to be moved by hand. This unofficial DSH plugin suite connects the officially logged-in Grok Build CLI to DeepSeek Harness as an ACP subagent. The official CLI keeps ownership of OAuth credentials; the plugin neither reads nor copies them.

It then fills the practical multimodal gaps around that subscription connection: Grok subagent tasks, image understanding, Imagine tools, persistent audio/video cards, speech tools, and an original-file-first long-video workflow.

What it provides:

• A Grok subscription-backed subagent inside DSH through the official Grok Build ACP process.
• Grok task execution, image understanding, and Imagine image/video tools.
• Native audio/video cards with seeking and restart persistence.
• TTS, STT, and video analysis via a user-provided XAI_API_KEY.
• MP4/MOV files up to 50 MB can be analyzed with the complete original file and soundtrack; larger/unsupported inputs fall back to sampled frames plus timestamped, speaker-aware transcription.
• Explicit consent before either an original file or derived media leaves the machine.

Install the release tarball:

dsh plugin --profile web add https://github.com/xisheng687/dsh-grok-subscription/releases/download/v0.2.0/dsh-subscription-media-suite-0.2.0.tgz
NODE_USE_ENV_PROXY=1 dsh web

Requirements: DSH 0.1.0-rc.7+, Node 22.19+, ffmpeg/ffprobe, and an officially logged-in grok CLI for subscription-backed ACP. TTS, STT, and original-file video analysis are separate xAI API features and require your own XAI_API_KEY; they are not included in subscription OAuth.

The public API documents file attachments but does not promise an internal "video token" representation. This project therefore calls the feature original-file analysis, not native video tokens.

The implementation and release audit were developed primarily with Codex. See README.zh.md for tested behavior, limits, and full credits.

Unofficial community software; not endorsed by xAI or DeepSeek.