Yan-Zero/dsh-codex
123Last commit Aug 15, 2026
dsh-codex DSH plugin
dsh-codex adds ChatGPT OAuth login, the Codex GPT catalog, streaming, tool calls, and more. It supports image input/output and web search, all without modifying the dsh source.
How to install the dsh-codex DSH plugin
dsh plugin --profile web add dsh-codexCopying does not run this command. Review the repository and version before installing the dsh-codex DSH plugin.
dsh-codex DSH plugin data source
dsh-codex DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-codex DSH plugin can do
- ChatGPT OAuth login with automatic token refresh from the dsh Settings panel or a standalone CLI
- Codex GPT catalog including vision-capable models
- Streaming, tool calls, reasoning replay, prompt caching, and dsh compaction
- Codex standalone web search via dsh's existing web_search tool
- Image input via paste, drag-and-drop, or HTTP(S) URL, and image generation via gpt-image-2
Where the dsh-codex DSH plugin fits
- Use a ChatGPT subscription inside DeepSeek Harness without needing an OpenAI API key
- Leverage ChatGPT's vision capabilities for image analysis
- Generate images using gpt-image-2 with workspace or conversation reference images
- Perform web searches through the Codex search backend
- Run in headless or TUI environments with CLI commands for login, status, and logout
Who the dsh-codex DSH plugin is for
- Users with a ChatGPT subscription who want to integrate it into DeepSeek Harness workflows
- Developers seeking to use the Codex model catalog and image generation features without an OpenAI Platform API key
dsh-codex DSH plugin limitations
- Requires a ChatGPT subscription; it does not turn a subscription into a general-purpose OpenAI API credential
- The Codex endpoint does not enforce the ordinary Responses max_output_tokens field, and compaction's summary cap cannot be imposed server-side on this route
dsh-codex DSH plugin: from the repository README
Quoted from the Yan-Zero/dsh-codex README, the upstream source of the dsh-codex DSH plugin. Copyright remains with the original authors.
English | [中文](README.zh.md) Use a ChatGPT subscription in [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) through OpenAI's Codex sign-in flow—no OpenAI Platform API key required and no dsh source patch required. `dsh-codex` is an independent dsh bundle. It adds: - ChatGPT OAuth from the dsh Settings panel or a standalone CLI, with automatic token refresh - the Codex GPT catalog, including vision-capable models when the account offers them - streaming, tool calls, reasoning replay, prompt caching, and dsh compaction through the normal LLM service - Codex standalone web search through dsh's existing `web_search` tool - optional HTTP(S) URL input added to Harness's existing `read_image` tool - an `imagegen` tool backed by `gpt-image-2`, with workspace or conversation reference images and automatic workspace output - browser image input through dsh's existing paste and drop controls ChatGPT subscription authentication and usage-based OpenAI API access are different products. This plugin uses the ChatGPT Codex backend only; it does not turn a subscription into a general-purpose OpenAI API credential. ## Install Install the prebuilt bundle from npm into the sel
Read the full READMERepository license: Apache-2.0
dsh-codex DSH plugin questions
How do I install dsh-codex?
Run `dsh plugin --profile web add dsh-codex` to install the prebuilt bundle from npm into the selected dsh profile. Then start the web interface with `dsh web`. For a source checkout, use `pnpm dsh plugin --profile web add dsh-codex`.
Do I need an OpenAI API key to use this plugin?
No, you do not need an OpenAI Platform API key. The plugin uses the ChatGPT Codex sign-in flow with your ChatGPT subscription credentials. You must have a valid ChatGPT subscription.
Can I use image generation with non-Codex models?
The image generation tool (imagegen) is only available to vision-capable conversation models. The Settings page has a toggle to enable or disable image generation for other models. When disabled, imagegen is only available for Codex vision models.
How do I log out or remove my credentials?
Use the account page in the Settings panel or run the CLI command `dsh plugin --profile web exec dsh-openai-codex logout`. Removing the bundle does not delete the credential file; you must log out explicitly.
Does the plugin support headless or terminal environments?
Yes. You can install the bundle into the dsh-tui profile with `dsh plugin --profile dsh-tui add dsh-codex`. Use CLI commands like `dsh plugin --profile web exec dsh-openai-codex login` for authentication. The TUI provides `/codex` commands for status, login, logout, usage, and config.