Back to search
dsh-harness-codex
MCP serverGitHub
Codex-style agent preset for DeepSeek Harness
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/spectershell--dsh-harness-codex)HTML
<a href="/listings/spectershell--dsh-harness-codex"><img src="/api/listings/spectershell--dsh-harness-codex/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
dsh plugin --profile web add @spectershell/dsh-harness-codex
After restarting DSH, the **Codex mode**, **Codex strict mode**, **Codex PTC** and **Codex Creator** presets are available when a session is started. The package requires DSH 0.2.2-rc.1 or a later 0.2 release and Node.js 24.9 or newer.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 108 lines
- # @spectershell/dsh-harness-codex
- [](https://github.com/SpecterShell/dsh-harness-codex/actions/workflows/ci.yml)
- [](https://www.npmjs.com/package/@spectershell/dsh-harness-codex)
- [简体中文](README.zh-Hans.md)
- An agent preset for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that reproduces the working style of OpenAI Codex. The agent reads and searches through the shell, edits files with `apply_patch`, and runs each command in its own process. Tool names, schemas, output formats and prompts follow Codex, so GPT models operate as they were trained to. Other models receive the same tools with a prompt written for them.
- ## Installation
- ```sh
- dsh plugin --profile web add @spectershell/dsh-harness-codex
- ```
- After restarting DSH, the **Codex mode**, **Codex strict mode**, **Codex PTC** and **Codex Creator** presets are available when a session is started. The package requires DSH 0.2.2-rc.1 or a later 0.2 release and Node.js 24.9 or newer.
- ## Features
- ### Presets
- | Preset | Description |
- | --- | --- |
- | **Codex mode** | The Codex tools plus the host tools that do not overlap with them. <ul><li>Hides only the built-ins that duplicate a Codex tool (`read`, `write`, `edit`, `glob`, `grep`, `read_image`, `bash`, `pwsh`, `todo_write`)</li><li>Everything else passes through, including tools from plugins installed later</li><li>Subagents, messaging and workflows for delegation</li></ul> |
- | **Codex strict mode** | The strict preset: the model sees only the Codex tools. <ul><li>Five Codex tools, plus the `skill` loader for the skills this package ships</li><li>Tools contributed by other profile plugins are hidden</li><li>Subagents, messaging and workflows for delegation</li></ul> |
- | **Codex PTC** | The Codex tools reached from inside one program per call. <ul><li>`run_code` is the only tool called directly; every Codex tool is available inside the program</li><li>Carries the delegation group from DSH's standard preset, so `subagent`, `subagent_fork` and `workflow` work from a program</li><li>The persona keeps the inherited guidance instead of replacing it, and the free-form patch bridge stays off because PTC rejects direct tool calls other than `run_code`</li></ul> |
- | **Codex Creator** | The strict tool set plus the tools for writing DSH plugins. <ul><li>`cordis_inspect_list` and `cordis_inspect_query` for the live runtime API</li><li>The `skill` loader</li><li>The plugin manager and market tools when the profile exposes a plugin context</li></ul> |
- User-level and project-level `AGENTS.md` files continue to apply in all four.
- ### Tools
- | Tool | Description |
- | --- | --- |
- | `exec_command` | Runs a command in a new process. Returns its output, or a session identifier if it is still running. |
- | `write_stdin` | Polls a running session, or sends input to one started with `tty: true`. |
- | `apply_patch` | Edits files with a Codex patch. |
- | `update_plan` | Updates the plan shown in the To-dos panel. |
- | `view_image` | Shows a local image to the model. |
- The parameter and behavior details are in [docs/tools.md](docs/tools.md). The Codex mode, Codex strict mode and Creator presets also expose `skill`.
- ### Skills
- The package ships the `review-agent` skill, adapted from Codex's review-agent sample and licensed under the Apache License 2.0 as recorded in [NOTICE](NOTICE). The skill provider mounted by the Codex mode, Codex strict mode and Creator presets points at this package's [skills/](skills/) directory, so the model can load the review methodology whenever a change needs reviewing. The PTC preset leaves the skill rows out: PTC accepts only `run_code` as a direct call, and instructions fetched inside a program would reach the program result rather than the model as skill instructions. Codex's other bundled skills (image generation, OpenAI product documentation, the TUI statusline) depend on Codex features DSH does not have, so they are not ported. Image generation through the ChatGPT subscription is already covered by dsh-codex-subscription.
- ### Prompts
- The preset selects a system prompt from the model. GPT models receive Codex's own prompt for that model, taken from Codex's model catalog. Other models receive [prompts/original.md](prompts/original.md).
- | File | Used for |
- | --- | --- |
- | [prompts/original.md](prompts/original.md) | Every non-OpenAI model |
- | [prompts/codex/prompt.md](prompts/codex/prompt.md) | OpenAI-style models outside the catalog |
- | [prompts/codex/gpt-5.5.md](prompts/codex/gpt-5.5.md) | gpt-5.5 |
- | [prompts/codex/gpt-5.6-sol.md](prompts/codex/gpt-5.6-sol.md) | gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, codex-auto-review, gpt-daybreak-blue-latest |
- | [prompts/codex/gpt-6-astra.md](prompts/codex/gpt-6-astra.md) | gpt-6-astra, gpt-6.1-terra |
- | [prompts/codex/gpt-6-luna.md](prompts/codex/gpt-6-luna.md) | gpt-6-luna |
- | [prompts/codex/gpt-6-sol.md](prompts/codex/gpt-6-sol.md) | gpt-6-sol |
- | [prompts/codex/gpt-6.1-sol.md](prompts/codex/gpt-6.1-sol.md) | gpt-6.1-sol |
- | [prompts/codex/gpt-6.2-sol.md](prompts/codex/gpt-6.2-sol.md) | gpt-6.2-sol, gpt-6.2-astra |
- | [prompts/codex/gpt-daybreak-red-latest.md](prompts/codex/gpt-daybreak-red-latest.md) | gpt-daybreak-red-latest |
- | [prompts/codex/compact-prompt.md](prompts/codex/compact-prompt.md) | Compaction request |
- | [prompts/codex/compact-summary-prefix.md](prompts/codex/compact-summary-prefix.md) | Compaction summary prefix |
- The catalog files are generated from a Codex checkout. See [CONTRIBUTING.md](CONTRIBUTING.md).
- ### Instructions
- Project instruction files load with Codex's precedence: within each directory, `AGENTS.override.md` replaces `AGENTS.md`, and the chain runs from the project root down to the working directory under a 32 KiB budget. User-level files continue to come from DSH, and project files are re-read at every step.
- ### Free-form patches
- Codex presents `apply_patch` to GPT models as a free-form grammar tool rather than a JSON function. This package can reproduce that behavior on any provider that speaks the OpenAI Responses API, including the ChatGPT subscription, OpenRouter and compatible endpoints. The feature is disabled by default. See [docs/freeform.md](docs/freeform.md).
- ### Compaction
- The preset replaces DSH's own compaction engine with a local one that follows Codex's rule. When the context approaches 90% of the model's window, the history is replaced by a summary plus the newest original user messages that fit in 20,000 tokens. `/compact` runs the same engine on demand, automatic compaction that would not shrink the context is skipped, and a failed summary leaves the context untouched.
- Cloud compaction is not part of this package. Server-side compaction belongs to provider plugins such as [dsh-codex-subscription](https://github.com/WSL043/dsh-codex-subscription), which the ChatGPT subscription already supplies.
- ## Settings
- The plugin's settings form, rendered in the DSH settings and on the plugin's detail page under Plugins, holds the free-form patch controls, the surface allow list and the project instruction budget. Saved values apply live and need no restart. The same values are served as JSON at `/codex/settings.json` for diagnostics. The fields are listed in [docs/configuration.md](docs/configuration.md).
- ## Documentation
- - [Tools](docs/tools.md)
- - [Configuration](docs/configuration.md)
- - [Free-form patches](docs/freeform.md)
- - [Compaction](docs/compaction.md)
- - [Differences from Codex](docs/differences.md)
- - [Benchmark](docs/benchmark.md)
- - [Changelog](CHANGELOG.md)
- ## Development
- ```sh
- pnpm install
- pnpm build
- pnpm test
- ```
- The tests require a DSH installation (`npm install -g @deepseek-ai/dsh`). [CONTRIBUTING.md](CONTRIBUTING.md) describes how to link a local build into a test profile and how to run the evaluation.
- ## License
- [Apache-2.0](LICENSE). Attribution for the bundled Codex material is in [NOTICE](NOTICE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.