Introduction

The DSH ecosystem emphasizes “everything is a plugin,” allowing different tools to be integrated into the same workflow. Here is a specific boundary issue: Codex can produce plans or review comments, but code execution is best performed by DSH.

dsh-codex-workflow constrains this division of labor: Codex assumes read-only planning/review roles, while DSH remains the sole executor.

What is this

dsh-codex-workflow is a DeepSeek Harness plugin maintained by kui123456789. It integrates Codex’s planning and review results into the DSH workflow while preserving DSH’s role as the sole executor.

Core Features

Read-only Role Division

The plugin assigns read-only planning and review roles to Codex, and DSH is responsible for execution.

Codex-led bridge

  • The plan generated by the Codex task is sent to the exact live DSH session via a durable SQLite bridge.
  • DSH receives the plan and executes it.
  • Visible Markdown reviews are appended to existing workflow tasks.

DSH-led tools

  • DSH agents can autonomously initiate codex_workflow_start in complex development tasks.
  • Users can also explicitly request this workflow.

Reviewer and Authority

  • Reviewer turns, bridge callbacks, reconciliation, normalization, and authority alignment are all executed via the backend codex exec CLI.
  • Review authority alignment checks if findings and test gaps comply with the authority hierarchy.
  • When a conflict occurs, the plugin does not overwrite latestReview, does not increment reviewCycles, does not enter fixing, and does not send fix instructions.

Installation and Activation

Installation

First, install the plugin:

dsh plugin --profile web add dsh-codex-workflow

After installation, restart the DSH web profile.

Environment Requirements

  • DeepSeek Harness 0.1.0-rc.6
  • Node.js ^22.19.0 or >=24
  • Codex CLI with a valid ChatGPT login and App Server support

Development Verification

If building and verification are needed locally, first install dependencies, then run verification and checks:

pnpm install
pnpm verify
pnpm doctor

Typical Usage

Dispatching Plans from Codex Tasks

First, find the live DSH session corresponding to the current workspace:

dsh-codex-workflow sessions --cwd $PWD --json

Then dispatch the plan to the live DSH session. In the example, the payload is passed via --stdin and is not placed in command-line arguments:

$payload = '{"task":"实现搜索功能","planMarkdown":"<proposed_plan>…</proposed_plan>","assumptions":[]}'
$payload | dsh-codex-workflow dispatch --cwd $PWD --codex-thread $env:CODEX_THREAD_ID --stdin

Running Acceptance

If you need to run the project acceptance script:

pnpm run lifecycle:accept

Applicable Scenarios and Notes

Suitable for the following scenarios:

  • Want DSH to remain the sole executor, while Codex only performs planning/review.
  • Want to avoid opening or controlling the browser.
  • Do not want to introduce network listeners, MCPs, hooks, or skills.

Notes:

  • Browser clicking is a development-only workaround and is not part of the plugin itself.
  • After an audit is complete, the plugin will not open, refresh, navigate, or focus Codex Desktop.
  • The plugin runs with the permissions of the current dsh process, so source code and license should be checked before installation.
  • Current materials list a LICENSE file, but do not specify a clear license; project README materials appear truncated, and subsequent details are not fully provided.

Conclusion

The value of dsh-codex-workflow lies in separating “planning/review” and “execution”: Codex outputs plans and reviews, and DSH completes the implementation.

Project Directory Page: https://www.skillhub.cn/plugins/kui123456789/dsh-codex-workflow

GitHub: https://github.com/kui123456789/dsh-codex-workflow

The project directory here is an independent community directory and has no official affiliation with DeepSeek / Huafan.