wingoo/codex-plugin-dsh
40Last commit Aug 14, 2026
codex-plugin-dsh DSH plugin
This plugin allows DSH to connect to the Codex App Server running on your local machine, using your existing Codex account credentials. After installation, a new model group "Codex App Server (local)" appears in the model selector. The plugin supports image inputs and can write Codex's native image generation results back to the DSH conversation. Session management, tool calls, and permission handling remain under DSH's control.
How to install the codex-plugin-dsh DSH plugin
dsh plugin --profile web add github:wingoo/codex-plugin-dshCopying does not run this command. Review the repository and version before installing the codex-plugin-dsh DSH plugin.
codex-plugin-dsh DSH plugin data source
codex-plugin-dsh DSH plugin snapshot date: Aug 16, 2026
discovered
What the codex-plugin-dsh DSH plugin can do
- No OpenAI API Key needed – uses your local Codex login
- Supports image inputs and Codex native image generation output
- Compatible with existing DSH plugins and tools – tool calls are still managed by DSH
- Communicates with the local Codex App Server via stdio subprocess
- Preserves dynamic tool catalogs via App Server thread checkpointing
- Imports conversation history when switching from other DSH providers
Where the codex-plugin-dsh DSH plugin fits
- Use Codex models in DSH for chat without managing API keys
- Leverage Codex's image generation capabilities within DSH conversations
- Combine DSH's tool ecosystem (e.g., file editing, web browsing) with Codex's reasoning
- Migrate existing DSH sessions to Codex as the model provider seamlessly
Who the codex-plugin-dsh DSH plugin is for
- Developers who already have Codex CLI installed and logged in
- DSH users who want to use Codex models but avoid configuring OpenAI API Key in DSH
codex-plugin-dsh DSH plugin limitations
- App Server's item/tool/requestUserInput is not bridged and will fail
- Reasoning blocks or assistant images from other providers cannot be imported into App Server
- Unsupported configuration fields (temperature, maxTokens, stop) are rejected, not silently ignored
- Only verified on macOS; Windows testing is pending before first release
- Requires local Codex CLI >=0.147.0 and Node.js ^22.19.0 or >=24
codex-plugin-dsh DSH plugin: from the repository README
Quoted from the wingoo/codex-plugin-dsh README, the upstream source of the codex-plugin-dsh DSH plugin. Copyright remains with the original authors.
中文 | [English](https://github.com/wingoo/codex-plugin-dsh/blob/main/README.en.md)  在 DeepSeek Harness 里直接使用你本机已经登录的 Codex，无需在 DSH 中配置 OpenAI API Key。安装并重启后，现有模型选择器中会出现 **Codex App Server (local)**，选择模型即可开始对话。 会话和工具调用仍由 DSH 管理，现有 DSH 插件与工具可以照常使用；模型请求通过本地 Codex App Server 连接当前 Codex 账户。插件也支持图片输入，并能把 Codex 原生图片生成结果直接回写到 DSH 对话。 ## 快速安装：直接让 DSH 完成 如果当前 DSH 会话具有完整的宿主机权限，把下面这段话直接发给它： ```text 请将 github:wingoo/codex-plugin-dsh 安装到当前 DSH 的 web profile，不要修改 DeepSeek Harness 源码。 1. 检查本机是否已经安装符合插件要求的 Codex CLI；如果尚未安装或版本过旧，请先按照 OpenAI 官方方式安装或升级。 2. 运行 codex login status 检查登录状态。如果尚未登录，请让我在运行 DSH 的主机终端执行 codex login；等我完成浏览器登录并回复“已登录”后再继续。 3. 确认 codex app-server --help 可以正常运行。 4. 安装插件，并通过 dsh --profile web --dump-config 确认 codex-app-server-provider 已加载。 5. 沿用当前 DSH Web 服务原来的启动方式完成重启，不要在同一端口启动第二个实例。重启前提醒我连接会暂时中断。 6. 服务恢复后提醒我刷新页面，并在现有模型选择器中选择 Codex App Server (local)。 如果无法可靠判断原来的启动方式，不要猜测或结束无关进程，直接告诉我应该执行的重启命令。 ``` 这会修改 DSH profile 并在宿主机上运行插件代码，请先确认仓库来源。重启期间当前连接会暂时中断，服务恢复后刷新页面即可。 ## 通过命令行安装 ```sh dsh plugin --profile web add github:wingoo/codex-plugin-dsh ``` 如果从 DeepSeek Harness 源码仓库运行： ```sh pnpm dsh
Read the full READMERepository license: MIT
codex-plugin-dsh DSH plugin questions
How do I install this plugin?
You can install it by sending the installation command to a DSH session with full host permissions, or by running `dsh plugin --profile web add github:wingoo/codex-plugin-dsh` in your terminal. The plugin will check for Codex CLI, ensure it's logged in, and restart your DSH web service. For detailed instructions, see the "Quick Install" section in the README.
What are the prerequisites?
You need Node.js >=22.19.0 or >=24, DeepSeek Harness >=0.1.0-rc.5 <0.2.0, and Codex CLI >=0.147.0 installed and logged in (`codex login`). The plugin uses your local Codex installation; it won't download or upgrade Codex for you.
How do I update the plugin after installation?
You can update by sending the update command provided in the README to a DSH session with full host permissions, or by running `dsh plugin --profile web update codex-plugin-dsh` in your terminal. The update will refresh the GitHub commit reference and keep your existing plugin configuration. After updating, you must restart the DSH web service to load the new code.
Does the plugin support image inputs and image generation?
Yes. The plugin supports image inputs as data URLs (no shared file paths needed). Codex's native image generation is intentionally allowed and results are saved as DSH image attachments and displayed in the conversation. Whether image generation is available depends on your Codex account, model, and App Server capabilities.
Can I use all Codex models?
The plugin exposes the models available through your local Codex App Server. The exact model list depends on your Codex account and the App Server's catalog. You choose the model from the "Codex App Server (local)" group in the DSH model selector. Some models may not support certain features like image generation.