deepseekplugins

DeepSeek Harness plugin

deepseek-openai-codex

ChatGPT-subscription OpenAI Codex adapter for DeepSeek Harness through Pi's direct provider path

Tools & Capabilities
Jump to install

Source facts

Repository
OpenCnid/deepseek-openai-codex
Latest update
Aug 20, 2026
Category
Tools & Capabilities
GitHub stars
2
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/OpenCnid/deepseek-openai-codex
Plugin: deepseek-openai-codex
Author: OpenCnid

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

<p align="center"> <a href="https://github.com/OpenCnid/deepseek-openai-codex"> <img src="./artifacts/deepseek-openai-codex.svg" alt="DeepSeek Harness to OpenAI Codex through a Cordis plugin" width="100%"> </a> </p>

<p align="center"> <img alt="Node.js 22.19 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-5FA04E?style=flat-square&logo=nodedotjs&logoColor=white"> <img alt="DeepSeek Harness 0.1.0 release candidate 7" src="https://img.shields.io/badge/DeepSeek_Harness-0.1.0--rc.7-4D6BFE?style=flat-square"> <img alt="Cordis 4.0.1" src="https://img.shields.io/badge/Cordis-4.0.1-8B5CF6?style=flat-square"> <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-6-3178C6?style=flat-square&logo=typescript&logoColor=white"> </p>

OpenAI Codex for DeepSeek Harness

Use OpenAI Codex models from an eligible ChatGPT subscription inside DeepSeek Harness. This standalone Cordis plugin adds the openai-codex provider while DeepSeek Harness continues to own the agent loop, tools, approvals, sessions, and UI.

> [!IMPORTANT] > The plugin currently supports DSH 0.1.0-rc.7 only and is not published > to npm. Install it from a local checkout as shown below.

Why this plugin

  • Subscription OAuth: signs in with ChatGPT; it does not use

OPENAI_API_KEY or API-key billing.

  • Native Harness workflow: Codex models appear in the normal DeepSeek

Harness model picker and participate in regular tool calls.

  • Host-owned credentials: OAuth state is stored through DSH credentials,

with validation, refresh serialization, bounded replay, and sanitized errors.

  • Direct provider path: requests stream through

@earendil-works/pi-ai; no Codex CLI or codex app-server is required.

DeepSeek Harness  →  Cordis plugin  →  Pi AI  →  OpenAI Codex Responses API
 agent + tools        auth + adapter    OAuth        streamed response

Quick start

Prerequisites: Node.js >=22.19.0, pnpm 11.19.0, and the complete DeepSeek Harness 0.1.0-rc.7 package set.

git clone https://github.com/OpenCnid/deepseek-openai-codex.git
cd deepseek-openai-codex
pnpm install --frozen-lockfile
pnpm run build
pnpm pack --pack-destination ./dist-pack

Install the packed plugin into your DSH profile, verify its configuration, and start the profile:

dsh plugin --profile web add ./dist-pack/deepseek-openai-codex-0.1.0.tgz
dsh --profile web --dump-config
dsh --profile web

The config dump should contain exactly one row with the id deepseek-openai-codex.

Connect your ChatGPT subscription

1. In DSH, open Settings → Plugins. 2. Find OpenAI Codex and select Sign in with ChatGPT. 3. Choose the browser or device-code flow and complete the prompts. 4. Wait for Configured, then select an OpenAI Codex model from the normal model picker.

<p align="center"> <img src="./artifacts/openai-codex-assembled-flow.gif" alt="Safe assembled DeepSeek Harness sign-in, model selection, tool round trip, logout, and removal workflow" width="900"> </p>

<p align="center"><sub>Safe assembled workflow: sign in → select a model → run a tool round trip → log out. No real credential is recorded.</sub></p>

<details> <summary>View the key screens</summary>

Sign inChoose a Codex modelComplete a tool round trip
![OpenAI Codex plugin card before sign-in](artifacts/01-not-configured.jpg)![OpenAI Codex models in the DSH model picker](artifacts/06-provider-selection.jpg)![Completed model and tool round trip](artifacts/07-model-tool-roundtrip.jpg)

</details>

Credential safety

OPENAI_CODEX_OAUTH is a plugin-owned DSH credential reference containing a Pi OAuth credential—not a generic API key. Do not copy it into settings, edit it manually, reuse it for another provider, or commit it. Sign-in succeeds only after the credential is durably stored; logout removes it through the active credential provider.

ChatGPT subscription access and OpenAI API billing are separate products. Setting OPENAI_API_KEY does not configure this plugin and is never used as a fallback.

Common fixes

  • Plan or permission error: confirm the ChatGPT account is eligible for

Codex subscription access, then sign in again.

  • Expired or cancelled login: select Retry sign-in in the plugin card.
  • Read-only credential provider: make the active provider for

OPENAI_CODEX_OAUTH writable.

  • Provider collision: remove the other plugin that owns openai-codex;

this plugin deliberately refuses to register an alias.

  • Plugin card does not load: confirm every DSH web package is from

0.1.0-rc.7.

See [COMPATIBILITY.md](COMPATIBILITY.md) for the audited package matrix and [INTEGRATION_PROOF.md](INTEGRATION_PROOF.md) for the clean-tarball and assembled DSH acceptance record.

Development

pnpm install --frozen-lockfile
pnpm run typecheck
pnpm run lint
pnpm run test
pnpm run build
pnpm run pack:inspect

The test suite covers credential durability and locking, auth coordination, mounted Host Remote calls, request and stream conversion, Pi's direct transport, browser interactions, lifecycle cleanup, and package metadata.

The implementation contract lives in [SPEC.md](SPEC.md). Contributor and agent guidance lives in [AGENTS.md](AGENTS.md), and adapted DSH conversion code is acknowledged in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

Remove

dsh plugin --profile web remove deepseek-openai-codex

Restart the profile after removal. Uninstalling does not silently delete stored credentials; use Log out first if you also want to remove OPENAI_CODEX_OAUTH.

Release status

The package is implemented, tested, locally packable, intentionally private, and not published. A public release still requires repository-owner decisions about licensing, package ownership, visibility, and third-party notices. Do not publish it until those gates are resolved.

Back to searchOpen GitHub repository

More related plugins

View category