Introduction

DSH supports plugin extensions; the community directory is an independent site with no official affiliation to DeepSeek / Hypersphere. DSH’s philosophy is “everything is a plugin,” allowing plugins to extend DSH Web’s session capabilities without directly modifying the source code.

In the same dsh web page, switching between DSH’s Agent flow and Grok Build typically requires opening two separate interfaces. DSH Agent Bridge aims to solve this by placing Grok Build as an ACP-powered root agent into DSH Web’s empty session selection, while continuing to use DSH Web’s input box, tool display, permission confirmation, and Markdown diff interface.

What is this

DSH Agent Bridge is maintained by zmh2000829, with the repository at zmh2000829/DSH-agent-bridge, and the installation name is dsh-grok-acp.

Its one-sentence positioning is: Use Grok Build as an ACP-powered root agent inside DeepSeek Harness Web. In other words, it integrates Grok Build into DSH Web and maps ACP streaming output back to DSH Web’s readable and actionable results.

Current documentation indicates that the project currently only supports Grok Build, and there is no Codex or Claude Code adapter currently. Plugins are installed as independent DSH Bundles, without modifying global npm packages or the DeepSeek Harness source code.

Core Features

  • Select DSH or Grok Build in the same dsh web page.
  • DSH mode dynamically reads the Agent presets provided by the current deployment and retains existing models and plugins.
  • Grok Build mode only displays the models and reasoning intensity actually reported by ACP, and hides irrelevant DSH Agent presets.
  • ACP streaming output is mapped to DSH’s answer, thinking, tool calls, and diff.
  • Planned to update the native task panel collapsible above the input box, no longer repeatedly writing to the answer body.
  • Each round of Grok tool calls is collapsed into one prominent activity summary; click to expand the full timeline; automatically expands on failure.
  • File modifications, Markdown diff, and permission requests are displayed independently.
  • Grok permission requests enter DSH’s approval interface.
  • DSH’s Full access is synchronized to Grok ACP file access and approval policies.
  • Supports Grok commands such as /usage, /context, /session-info, /btw, /model, /models, /effort, etc., and is compatible with the /uasge spelling.
  • /model and /models only display the current Harness’s models.
  • Empty sessions can switch Harness; it is locked after the first message is sent to avoid one history being generated jointly by two Agent engines.
  • Multiple Grok sessions share an ACP process started on demand; it automatically closes when idle.
  • After an ACP process abnormal exit, the next request automatically restarts the process and restores the corresponding Grok session.

Installation and Enablement

Prerequisites

  1. macOS or an environment capable of running the Grok Build CLI.
  2. Node.js ^22.19 or >=24.
  3. Globally install DeepSeek Harness 0.1.1-rc.2, and ensure dsh web can start normally.
  4. Grok Build CLI is installed and logged in, and grok --version can be executed successfully.

Install from npm

Install the plugin first, then start DSH Web:

dsh plugin --profile web add dsh-grok-acp@latest
dsh web

After starting, open the 3080 page and create a new session. If the browser cache has an old frontend, perform a hard refresh.

Install from local project path

If the project is already on the machine, you can also specify the full path for installation. The path below is an example path; replace it with the actual project directory on your machine:

dsh plugin --profile web add /Users/your-name/Projects/DSH-agent-bridge
dsh web

Check installation

Use the following command to check the plugin status under the current Web profile:

dsh plugin --profile web exec dsh-grok doctor

Typical Usage

  1. Start dsh web and open the 3080 page.
  2. Click “New Session”.
  3. Select DSH or Grok Build below the input box.
  4. When selecting DSH, you can select four Agent presets above the input box; when selecting Grok Build, you can select Grok models and reasoning intensity on the right side of the input box.
  5. After sending the first message, the Harness for this session is locked; to switch Harness, please create a new session.

Grok Build sessions support the following commands:

  • /usage, /cost, /uasge
  • /context
  • /session-info
  • /btw <question>
  • /model
  • /models
  • /effort <level>
  • /compact
  • /goal
  • /workflow
  • /deep-research

Note that /model and /models only display the current Harness’s models.

Security and Notes

  • By default, sensitive operations require approval one by one, and the ACP file interface can only access the session working directory.
  • File read/write is restricted to the current session working directory by default, and accessing outside via absolute paths, .., or symbolic links is rejected.
  • yoloMode and allowOutsideWorkspace are both explicit high-privilege options; enable them only when risks are explicitly accepted.
  • Browser bridging routes only accept loopback Host and reject cross-site requests; write operations require same-origin JSON requests.
  • The plugin is currently developed for DSH 0.1.1-rc.2; DSH pre-release versions may change internal AgentFactory or client Slot API.
  • This plugin calls the local Grok Build CLI subprocess; check the source code and MIT License before installing.
  • Do not manually edit ~/.dsh/profiles/web/package.json.
  • Uninstalling the plugin will not delete Grok’s own login information or session files.

Update and Uninstall

Update npm installation:

dsh plugin --profile web add dsh-grok-acp@latest

Uninstall plugin:

dsh plugin --profile web remove dsh-grok-acp
dsh web

Conclusion

The value of DSH Agent Bridge is to integrate Grok Build into DSH Web’s session selection, while retaining DSH Web’s native display, tool timeline, permission confirmation, and diff display. Current materials do not provide a confirmed directory page URL; the repository address is:

https://github.com/zmh2000829/DSH-agent-bridge