dsh-codex
Manifest validReview changes or delegate investigation and fix tasks to the local Codex CLI.
dsh-codex
Bring openai/codex-plugin-cc into DeepSeek Harness: let your local Codex CLI review your changes, or hand investigation and fix tasks to it.
Install
# straight from GitHub
dsh plugin add github:zhang6hk/dsh-codex
# or from npm
dsh plugin add @zhang6hk/dsh-codex
Desktop: Plugins → Add plugin, then paste either spec. Restart the session and run /codex-setup to confirm Codex is ready.
Requirements
- Codex CLI:
npm install -g @openai/codex - Logged in:
codex login(ChatGPT account or API key) - Node.js ≥ 22 (DSH's bundled runtime is enough)
Commands
| Command | What it does |
|---|---|
/codex-review | Review the current git diff (native review, never edits code) |
/codex-adversarial-review <focus> | Adversarial review: challenge the approach, tradeoffs, assumptions |
/codex-rescue <task> | Hand investigation or fixes to Codex, staying in one thread |
/codex-status [job-id] | Check progress |
/codex-result <job-id> | Read the full result |
/codex-cancel <job-id> | Cancel a task |
/codex-setup | Check CLI, login, and runtime |
Reviews run in the foreground and print Codex's report directly (the upstream engine has no review background mode). /codex-rescue runs in the background by default and returns a job id. Flags: --base <ref>, --scope auto|working-tree|branch, --model, and --cwd <dir> to review another checkout or worktree (relative to the session directory). When the diff comes back empty the report names the directory it actually reviewed. Reviews take no --effort: the engine only accepts it for task, so this plugin rejects it rather than passing it through.
There is also a codex_task tool, so the model can delegate a task to Codex inside a conversation.
Configuration
Edit config in cordis.patch.yml:
- insert:
- id: dsh-codex
name: '@zhang6hk/dsh-codex'
config:
codexPath: codex # Codex binary; use an absolute path if it is not on PATH
model: '' # default model, forwarded as --model
effort: '' # default reasoning effort for /codex-rescue and codex_task (reviews ignore it)
defaultBase: '' # default review base, e.g. origin/main
maxConcurrent: 2 # concurrent Codex tasks
timeoutMs: 1800000 # per-run timeout (30 minutes)
Differences from upstream
Upstream is a Claude Code plugin; DSH has no slash-command files, shell hooks, or markdown subagents, so the port differs in a few places:
- Command names drop the colon:
/codex:review→/codex-review(DSH command names cannot contain:). - rescue becomes a tool: the
codex:codex-rescuesubagent maps to thecodex_tasktool plus/codex-rescue. - No
/codex:transfer: it reads~/.claude/projects, which has no DSH equivalent. - No Stop review gate: DSH has no shell hooks, so the gate toggle in
setupis inert. - Engine untouched:
vendor/codex/is a verbatim copy of upstreamplugins/codex/, adapted only throughCLAUDE_PLUGIN_DATA,CODEX_COMPANION_SESSION_ID, and PATH injection.
Development
node --test # unit tests
lib/args.js parses flags, lib/companion.js runs the child process, lib/commands.js assembles commands, lib/tool.js defines the tool, lib/index.js wires everything.
License
Apache-2.0. vendor/codex/ is derived from OpenAI's codex-plugin-cc; copyright OpenAI, with the original LICENSE and NOTICE preserved.
Comments
Loading…
Similar plugins
by apcamargo
Adds /review and /end-review code-review commands to DeepSeek Harness
★ 0
MIT
JavaScript
Oct 19, 2026
dsh plugin --profile web add @apcamargo/dsh-reviewRuns a diff past several reviewers at once — a CLI coding agent such as codex or claude, or a DSH subagent — and merges their separate sections into one report; reviewers and named review modes are co
★ 1
MIT
JavaScript
dsh plugin --profile web add dsh-reviewby kui123456789
DSH plugin that coordinates Codex planning and independent review while DSH executes.
★ 6
↓ 256/wk
MIT
TypeScript
Oct 25, 2026
dsh plugin --profile web add dsh-codex-workflowby vitas
A /review command that hands the current change set to a reviewer subagent pinned to the model you choose, with one continuing reviewer session per chat.
★ 0
MIT
JavaScript
Oct 1, 2026
dsh plugin --profile web add dsh-codex-reviewby halftin
Runs local Codex CLI tasks from DSH on Windows with background execution, progress queries, follow-up instructions, completed chat records, and optional supervision; requires Node 22.23.4+, DSH >=0.2.
★ 0
MIT
JavaScript
Nov 4, 2026
dsh plugin --profile web add dsh-codex-runnerby wuanthony397-hash
Run the local Codex CLI as a peer agent from DeepSeek Harness: split work between the two agents, hand tasks over, review each other's changes, and keep every run on disk.
★ 2
MIT
JavaScript
Oct 9, 2026
dsh plugin --profile web add dsh-codex-peer