suntianc/dsh-codex-auth
71Last commit Aug 15, 2026
dsh-codex-auth DSH plugin
dsh-codex-auth is a self-contained plugin for DeepSeek Harness that integrates with the official Codex CLI. It uses the ChatGPT login credentials from Codex to provide an openai-codex LLM route, a global web search provider, and image generation/editing tools. It also includes a GPT Auth settings section for managing login and configurations.
How to install the dsh-codex-auth DSH plugin
dsh plugin --profile web add dsh-codex-authCopying does not run this command. Review the repository and version before installing the dsh-codex-auth DSH plugin.
dsh-codex-auth DSH plugin data source
dsh-codex-auth DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-codex-auth DSH plugin can do
- Shared auth coordinator for LLM, search, and image operations using Codex CLI login
- Global web search provider through chatgpt.com/backend-api/codex/alpha/search
- Image generation and editing via generate_image tool with support for references and multiple outputs
- list_images tool for cataloging durable session images
- GPT Auth settings section with Login, Web Search, and Image Creation cards
- Configurable transport (SSE, WebSocket, auto) and timeout settings
Where the dsh-codex-auth DSH plugin fits
- Use as the primary LLM provider in DSH by reusing existing Codex login
- Perform web searches within DSH agents using the bundled search provider
- Generate and edit images in DSH conversations using Codex image endpoints
- Manage Codex authentication status and view usage remaining from DSH settings
- Develop DSH agents that combine LLM, search, and image capabilities without separate API keys
Who the dsh-codex-auth DSH plugin is for
- Developers using DeepSeek Harness who want to leverage Codex CLI capabilities
- Users who already have a Codex login and want to reuse it in DSH for LLM, search, and image tasks
dsh-codex-auth DSH plugin limitations
- Requires Codex CLI installed and logged in via `codex login` before use
- Unofficial channel; personal development only – not for production workloads
- auth.json may be empty if Codex stores credentials in OS keyring; requires config change
- Binary workspace export not available due to DSH API limitation; images persist only as conversation attachments
- WebSocket transport may be unreliable through common HTTP proxies; SSE is default
dsh-codex-auth DSH plugin: from the repository README
Quoted from the suntianc/dsh-codex-auth README, the upstream source of the dsh-codex-auth DSH plugin. Copyright remains with the original authors.
English | [中文](README.zh.md) Current release: **v0.2.0** A self-contained [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) **Codex Capability Bundle**. It reuses the ChatGPT login maintained by the official **Codex CLI** (`~/.codex/auth.json`, or `$CODEX_HOME/auth.json`) for: - the `openai-codex` LLM route; - a Global Codex Search Provider behind DSH's stock `web_search` tool; - durable image generation and editing through `generate_image`, plus the model-facing `list_images` catalog; - resilient weekly Codex usage status; - one native **GPT Auth** Settings section with Login, Web Search, and Image Creation cards. > **⚠️ Unofficial channel — personal development only.** The private, > account-gated `chatgpt.com/backend-api` surface is unsupported, revocable, and > may be rate-limited or changed without notice. Do not rely on it for > production workloads. ## Features ### Shared Codex Login State - Uses one Host-only auth coordinator for LLM, Search, and Image operations. - Resolves credentials through version-bound auth-file snapshots, a short-lived in-memory cache, and proactive refresh before expiry. - Coalesces concurrent refreshes in-process and
Read the full READMERepository license: MIT
dsh-codex-auth DSH plugin questions
How do I install dsh-codex-auth?
You can install it via npm using `dsh plugin --profile web add dsh-codex-auth`. Alternatively, you can install from a prebuilt release, GitHub source, or a local tarball. After installation, restart `dsh web` and open Settings to find the GPT Auth section.
Do I need to have a Codex CLI login?
Yes, dsh-codex-auth relies on the official Codex CLI login. You must have `codex` installed and run `codex login` before using the plugin. You can also initiate login from the GPT Auth card in DSH settings.
Can I use this plugin for production workloads?
No, this plugin uses an unofficial channel (chatgpt.com/backend-api) which is account-gated, revocable, and may be rate-limited. It is intended for personal development only. Do not rely on it for production.
What transport options are available for the LLM route?
The plugin supports SSE (default), WebSocket, and auto (WebSocket first with SSE fallback). WebSocket is unreliable through common HTTP proxies, so auto may fall back to SSE. You can configure the transport via the `transport` field in the Host configuration.
Why can't I export generated images to the workspace?
The current version of DeepSeek Harness (0.1.0-rc.6) does not expose a policy-aware binary workspace-write API. Generated images are persisted as durable conversation attachments, but workspace export is not offered. The plugin never bypasses DSH policy with direct Node filesystem access.