A DeepSeek Harness plugin that connects a ChatGPT subscription via OAuth and adds the openai-codex model catalog and optional GPT Image generation, with secret-free status/doctor diagnostics and Harness-native approvals.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-30
License
Apache-2.0
01What can it help you accomplish?
Connect a ChatGPT subscription to DeepSeek Harness so agents can use OpenAI Codex (GPT) models
The `openai-codex` model catalog (e.g. GPT-5.6 Luna) selectable in Harness's model picker, streamed through Harness's own LLM service
DeepSeek Harness (dsh) users who hold a ChatGPT subscription and want Codex/GPT models inside DSH without an OpenAI Platform API key
Generate images from a prompt inside DeepSeek Harness using the GPT Image capability
The exact generated image file preserved in plugin-owned storage plus a DSH attachment preview; copyable prompt and original/preview download
Harness users with a GPT subscription who want in-chat image generation without provisioning an OpenAI Platform API key
Verify install, OAuth and runtime state without exposing secrets
Secret-free JSON diagnostics from `status`/`doctor`/`capabilities` (signed-in state, package/Node metadata, conflict status, optional probe)
Operators and developers who need to confirm Codex Connect is wired correctly inside a Harness profile without printing credentials
02How to install into DeepSeek Harness
Prerequisites
- A working `dsh` (DeepSeek Harness) installation
- DSH plugin API packages `0.1.1-rc.2`, `@earendil-works/pi-ai` `0.82.1`, and Node.js `^22.19.0 || >=24.0.0` (the only verified combination)
Installation steps
- 01
Install the plugin into a profile: `dsh plugin --profile web add dsh-codex-connect@alpha` (replace `web` with your Harness profile name)
$ dsh plugin --profile web add dsh-codex-connect@alpha
- 02
Start Harness: `dsh web`
$ dsh web
- 03
Open Settings → Plugins → Plugin configuration → Codex Connect and click **Sign in with ChatGPT** to complete the browser approval
- 04
Optionally enable capabilities (search / view_image / image generation) in the same card and select **Save changes**
Verify the integration
- `status --json` reports `signed-in` and exits `0`
- `dsh --profile web --dump-config` shows exactly one `llm-openai-codex` row
03DSH integration and capability boundaries
DSH plugin (`dsh plugin add`) that registers the `openai-codex` model catalog and a ChatGPT OAuth login; models route through Harness's LLM service.
OpenAI Codex model catalog
ChatGPT OAuth sign-in→GPT/Codex models (e.g. GPT-5.6 Luna) selectable in Harness's model picker, routed through Harness's LLM service
Adds one `llm-openai-codex` config row; does not change the profile's default model or global search routeGPT Image generation
A prompt only (no size setting); a vision-capable openai-codex GPT model→Exact generated image file in plugin-owned storage plus a DSH attachment preview; copyable prompt; download original or preview
Stores originals below `$DSH_HOME/dsh-codex-connect/images/v1`; originals are owner-only and integrity-checked before downloadSecret-free diagnostics (status / doctor / capabilities)
None; optional `--model` and `--probe`→One secret-free JSON document per command (sign-in state, package/Node metadata, conflict status, optional Responses/SSE probe result)
Using `--probe` sends one fixed short request to the Codex Responses route and may consume quotaOptional capabilities: search, view_image, proxy
User toggles in the Codex Connect card (all off by default)→Registers Codex as a search provider, enables `view_image` for approved reads, or routes Codex requests through an optional proxy
Enabling `enableSearch` registers Codex as a search provider but does not select the profile's global search route
04Who is it for? When not to use it?
Good for
- DeepSeek Harness (dsh) users who hold a ChatGPT subscription and want Codex/GPT models inside DSH without an OpenAI Platform API key
- Harness users with a GPT subscription who want in-chat image generation without provisioning an OpenAI Platform API key
- Operators and developers who need to confirm Codex Connect is wired correctly inside a Harness profile without printing credentials
Not for
- By default the bundle is inert beyond model-provider registration; standalone search, view_image, and image generation stay disabled until you explicitly enable them in the Codex Connect card.
- Only one combination is verified: DSH plugin API packages `0.1.1-rc.2`, `@earendil-works/pi-ai` `0.82.1`, and Node.js `^22.19.0 || >=24.0.0`. Older API packages should upgrade to the rc.2 line.
05Compatibility, maintenance and safety notes
- By default the bundle is inert beyond model-provider registration; standalone search, view_image, and image generation stay disabled until you explicitly enable them in the Codex Connect card.
- Only one combination is verified: DSH plugin API packages `0.1.1-rc.2`, `@earendil-works/pi-ai` `0.82.1`, and Node.js `^22.19.0 || >=24.0.0`. Older API packages should upgrade to the rc.2 line.
- OAuth is stored separately at `$DSH_HOME/.openai-codex-auth.json` and `~/.codex/auth.json` is never copied or modified. Removing the package does not delete OAuth state, so run `logout` only when credential removal is intended.
Apache-2.0 · alpha channel via npm (`dsh-codex-connect@alpha`), no tagged release; last push 2026-08-29, curated
06Frequently asked questions
How do I install Codex Connect with DeepSeek Harness?
Run `dsh plugin --profile web add dsh-codex-connect@alpha` (replace `web` with your profile), then `dsh web`. Open Settings → Plugins → Plugin configuration → Codex Connect and click Sign in with ChatGPT. Verify with `dsh plugin --profile web exec dsh-codex-connect status --json`, which reports `signed-in` and exits 0.
What are the prerequisites?
You need a working `dsh` installation. The only verified combination is DSH plugin API packages `0.1.1-rc.2`, `@earendil-works/pi-ai` `0.82.1`, and Node.js `^22.19.0 || >=24.0.0`. Older API packages should be upgraded to the rc.2 line.
How does Codex Connect connect to DeepSeek Harness?
It registers an `llm-openai-codex` provider row and a separate ChatGPT OAuth login. Models stream through Harness's normal LLM service, so streaming, tool calls, compaction, permission gates and approval prompts remain Harness-owned — it is not an OpenAI Platform API credential.
How is this different from using OpenAI's API directly?
Codex Connect uses the image-generation and model access already included with your ChatGPT subscription; it does not require an OpenAI Platform API key and does not turn the subscription into an API credential. OAuth is stored separately at `$DSH_HOME/.openai-codex-auth.json` and never copies `~/.codex/auth.json`.
Troubleshooting: why does `status --json` exit 1?
A signed-out `status --json` exits 1 — that is expected, not a plugin failure. Return to the Codex Connect card and click Sign in with ChatGPT. For a secret-free health check, run `dsh plugin --profile web exec dsh-codex-connect doctor --json`.
07Related DSH workflows
dsh-routing-suite
by yjh051108
dsh-routing-suite — injector + router-standard kit: install the runtime injector first, then the task-aware reasoning-mode router preset (measured P1-P23).
brooks-lint
by hyhmrright
AI code reviews grounded in 12 classic engineering books — decay risk diagnostics with book citations, severity labels, and 6 analysis modes including full-sweep auto-fix
dsh-plugin-shop
by livxue
The most comprehensive DeepSeek Harness plugin market — refreshed daily, sourced across the Internet, reviewed before publishing.
anolisa
by agentic-os-org
ANOLISA (Agentic Nexus Operating Layer & Interface System Architecture) | Agentic OS with runtime, security, observability, and Tokenless response compression for lower token usage and cost.
08Data and sources
`dsh-codex-connect` adds the `openai-codex` model catalog and a separate ChatGPT OAuth login.
Harness's normal LLM service, so streaming, tool calls, reasoning replay, compaction, filesystem controls, permission ga…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-30. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.