dsh-codex-subscription-en

dsh plugin --profile web add dsh-codex-subscription-en

<div align="center">

DSH Codex Subscription

Use your ChatGPT / Codex subscription directly in DeepSeek Harness

Authored by Mamdouh Aboammar

No OpenAI API key or Codex CLI. Models, search, quota, and image generation stay inside DSH.




[Three-step start](#three-step-start) · [Install](#install) · [Contribute](CONTRIBUTING.md) · [Update and uninstall](#update-and-uninstall)

</div>

<p align="center">

<img src="https://raw.githubusercontent.com/imMamdouhaboammar/dsh-codex-subscription/main/docs/assets/readme-hero-en.webp" width="900" alt="Your Codex subscription inside DSH: models, web search, quota and safe reset, image generation, and Fast mode">

</p>

Three-step start

1. Install the plugin. Run the standard DSH bundle command:

   dsh plugin --profile web add @mamdouh-aboammar/dsh-codex-subscription

2. Sign in. Restart DSH yourself, open Settings -> Codex, and choose browser sign-in. No Codex CLI and no pasted token are required.

3. Use Codex. Select a Codex model. Quota, subscription search, image generation, and Fast mode remain inside DSH.

DSH-Portable exposes the same standard plugin command, so the command above also applies there. See below for the complete official npm, update, and uninstall routes.

Why this plugin

Capability · What you get

Subscription models · Sign in to ChatGPT and use Codex without an OpenAI API key or Codex CLI

Recoverable and diagnosable · Sign-in state reconciles automatically; failed reads can be retried in place, while timeouts and stale account responses cannot overwrite current state; Settings can create a support report without credentials or account identifiers

Visible quota · Keep backend-provided standard Codex, Spark, and other limits separate

Composer quota · Choose a compact percentage, progress bar, or no inline quota display

Safe quota reset · See each reset credit separately and deliberately try one with a cooldown and acknowledgement

Subscription search · Explicitly route search globally through DSH default search or the signed-in Codex subscription

Codex image generation and editing (Beta) · Generate without references, or explicitly edit one selected image; preview, zoom, annotate regions, download the original, and get the original host path for new or edited images

Fast mode · Switch between Standard and Fast directly in the composer

Model-aware context · Keep catalog defaults, use each model's supported extended window, or enter a full numeric token limit for each model; Settings refreshes the model directory on open, account changes, and connection resets without overwriting an unsaved draft

Headless runs · Use the same signed-in Codex provider for one-shot DSH tasks that print their answer and exit

These capabilities reuse the same local ChatGPT sign-in. Subscription routing failures stay visible and never silently switch to another paid route.

Product screen

<p align="center">

<img src="https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/context-settings-en.png" width="820" alt="Current Codex subscription settings in DeepSeek Harness with search, model-aware context, composer quota, and support diagnostics">

</p>

The screenshot illustrates the settings layout; available options can vary by DSH and plugin version.

Prepare DSH

This plugin supports the latest DeepSeek Harness release recorded in its package metadata and requires a ChatGPT account that currently has Codex access.

• Do not want to configure Node.js? Use DSH-Portable, a community portable desktop distribution for Windows, macOS, and Linux.
• Prefer the official route? Follow the DeepSeek Harness run guide.

Install

Standard DSH command

dsh plugin --profile web add dsh-codex-subscription

DSH owns target selection, profile locking, dependency resolution, and bundle activation; this is the plugin's only installation path.

Headless

After signing in and selecting a Codex model in Web once, install the same plugin in DSH's standard Headless profile:

dsh plugin --profile headless add dsh-codex-subscription
dsh --profile headless "Reply with only the word: ok"

<details>

<summary>Official npm route (Node.js installed)</summary>

The official npx @deepseek-ai/dsh web command does not create a global dsh command. Keep the full npx prefix when installing the plugin:

npx -y @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add dsh-codex-subscription
npx -y @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web list dsh-codex-subscription --depth 0
npx -y @deepseek-ai/dsh@0.1.2-rc.1 --profile web --dump-config

</details>

<details>

<summary>An existing <code>dsh</code> command</summary>

dsh plugin --profile web add dsh-codex-subscription
dsh plugin --profile web list dsh-codex-subscription --depth 0
dsh --profile web --dump-config

The plugin list should contain one dsh-codex-subscription, and the config should contain one codex-subscription entry.

</details>

Restart DSH manually after installation, then:

1. Open Settings -> Codex.

2. Sign in with a ChatGPT account that has Codex access.

3. Choose a search source.

4. Select a Codex model.

Features

• ChatGPT OAuth sign-in with credentials kept on the host; accounts are identified by a privacy-masked email that can be clicked to reveal, and can be manually added, swit

…(truncated)