franksong2702/dsh-codex-connect
111Last commit Aug 14, 2026
dsh-codex-connect DSH plugin
dsh-codex-connect adds the openai-codex model catalog and a ChatGPT OAuth login to DeepSeek Harness. Models run through Harness's normal LLM service, keeping streaming, tool calls, and approval prompts Harness-owned. It does not turn a ChatGPT subscription into an OpenAI Platform API credential.
How to install the dsh-codex-connect DSH plugin
dsh plugin --profile web add dsh-codex-connect@alphaCopying does not run this command. Review the repository and version before installing the dsh-codex-connect DSH plugin.
dsh-codex-connect DSH plugin data source
dsh-codex-connect DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-codex-connect DSH plugin can do
- Adds the `openai-codex` model catalog with ChatGPT OAuth login
- Provides `enableSearch` and `enableImageTool` capabilities (disabled by default)
- Offers `doctor` and `status` CLI commands for diagnostics and sign-in state
- Stores OAuth credentials separately with atomic writes and file locking
- Supports configurable search model, mode, context size, and max output tokens
Where the dsh-codex-connect DSH plugin fits
- Use a ChatGPT subscription to power models in DeepSeek Harness without an OpenAI API key
- Enable the Codex search provider for Harness search routes
- Enable the `view_image` tool for vision-capable models on approved local reads and public-network fetches
- Diagnose plugin health and sign-in status with `dsh plugin exec` commands
Who the dsh-codex-connect DSH plugin is for
- DeepSeek Harness users who have a ChatGPT subscription
- Developers who want to extend Harness with OpenAI Codex models via OAuth
dsh-codex-connect DSH plugin limitations
- Alpha stage: only compatible with Harness 0.1.0-rc.5 and 0.1.0-rc.6 plugin APIs, and Node.js ^22.19.0 || >=24.0.0
- Requires an active ChatGPT subscription; model access, quotas, and backend behavior are controlled by OpenAI
- `enableSearch` and `enableImageTool` are off by default and must be explicitly enabled
- The Codex endpoint does not enforce the `max_output_tokens` field; compaction still works but the cap cannot be server-side imposed
- Remote `view_image` URLs are limited to public HTTP(S) destinations; no localhost, private networks, or cloud metadata endpoints
dsh-codex-connect DSH plugin: from the repository README
Quoted from the franksong2702/dsh-codex-connect README, the upstream source of the dsh-codex-connect DSH plugin. Copyright remains with the original authors.
English | [中文](docs/README.zh.md) Connect your ChatGPT subscription to DeepSeek Harness with OAuth, user-controlled defaults, Harness-native approvals, diagnostics, and reliable session recovery. <p align="center"> <img src="https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/docs/assets/en/hero.jpg" alt="Codex Connect — ChatGPT OAuth for DeepSeek Harness" width="100%"> </p> `dsh-codex-connect` adds the `openai-codex` model catalog and a separate ChatGPT OAuth login. Models run through Harness's normal LLM service, so streaming, tool calls, reasoning replay, compaction, filesystem controls, permission gates, and approval prompts remain Harness-owned. It does not turn a ChatGPT subscription into an OpenAI Platform API credential. Installation is additive. The bundle does not replace the current default model or search route, and its standalone search provider and `view_image` tool are disabled until explicitly enabled. Every UI screenshot in this English guide is captured from the English-localized Harness UI. The [Chinese guide](docs/README.zh.md) uses a Chinese capture of the same state. Model and provider identifiers keep their canonical spelling in both
Read the full READMERepository license: Apache-2.0
dsh-codex-connect DSH plugin questions
How do I install dsh-codex-connect?
Run `dsh plugin --profile web add dsh-codex-connect@alpha` in your terminal. Replace `web` with the profile name you use. You need a working DSH installation first. The package is added to that profile without changing the default model or search route.
Why can't I see the openai-codex models in the model picker?
After installing the plugin, you must sign in with ChatGPT via the plugin configuration card in Settings → Plugins → Plugin configuration → Codex Connect. Click 'Sign in with ChatGPT' and complete the browser flow. Then the models will appear under the 'OpenAI Codex' group in the model picker.
What does enableSearch do?
When set to `true`, it registers Codex as an available search provider in Harness. Note that this does not automatically select the profile's global search route; you must also configure the search route separately if desired. By default, this capability is disabled.
How can I check if the plugin is signed in?
Run `dsh plugin --profile web exec dsh-codex-connect status --json`. If signed in, it exits with code 0 and reports `signed-in`. If signed out, it exits with code 1. You can also run `dsh plugin --profile web exec dsh-codex-connect doctor --json` for a more detailed diagnostic report.
Does this plugin expose my ChatGPT credentials?
No. The OAuth token is stored separately in `$DSH_HOME/.openai-codex-auth.json` with owner-only permissions. The `doctor` and `status` commands never print credential contents. The plugin does not turn your subscription into a platform API key.