Preface

In DSH’s plugin mechanism, providers can be extended as plugins. If you have a ChatGPT subscription and wish to use Gpt series models in DSH sessions, @eddyskywalker/dsh-chatgpt-subscription provides an integration path. Below, we introduce its positioning, core capabilities, installation and activation methods, and the credential storage boundaries to be aware of.

What It Is

@eddyskywalker/dsh-chatgpt-subscription is a DSH plugin that registers the codex-chatgpt provider, displayed as Codex (ChatGPT Subscription). It enables DSH to access Gpt series models using the current host user’s ChatGPT OAuth login state, and provides supporting capabilities around login, quota, search, image generation, settings page, and sub-agent configuration.

The npm package author is eddyskywalker, and the GitHub repository is:

https://github.com/Aa728848/dsh-chatgpt-subscription

License information is not provided in the documentation. Before installation, it is recommended to review the source code and repository license.

Core Capabilities

Login and Credentials

The plugin uses Authorization Code + PKCE (S256) for login, completed via a one-time localhost callback. It supports token refresh, login cancellation, and account logout.

Regarding credential handling:

  1. Windows uses CurrentUser DPAPI for encrypted token storage;
  2. Linux uses a 0600 file exclusive to the current user;
  3. Tokens do not enter the browser, settings.yaml, or logs;
  4. OAuth tokens are only sent to https://auth.openai.com/oauth/token;
  5. Model, image, search, and quota addresses are fixed, with no endpoint override.

Model Integration

The plugin fixes the Codex Responses address, supporting streaming text, reasoning summaries, image input, and tool calls/results. It forwards DSH tool schemas as-is and is compatible with pwsh, powershell, bash, sh, and shell.

For error handling, 429/5xx errors are handled by DSH’s retry policy; 401 errors trigger a forced refresh and a single retry, with support for AbortSignal.

The model catalog includes:

gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5
gpt-5.4
gpt-5.4-mini
gpt-5.3-codex-spark

Among these, 5.6 Sol, Terra, and Luna default to 272K effective context, with options to select up to 1M in settings. The actual models available on an account are still determined by the ChatGPT plan, workspace policy, and upstream compatibility status.

Settings, Search, and Images

The settings page displays a redacted email, plan, last four digits of the account ID, connection status, quota, and subscription enhancement feature toggles.

The plugin also provides the following capabilities:

  1. A Codex search provider on the ChatGPT subscription side, allowing users to switch between DSH default search or Codex subscription search in the settings page;
  2. A codex_image_generate tool that generates images and saves them via the DSH attachment system for rendering in the conversation;
  3. An optional composer quick-usage badge, showing the remaining quota for the most constrained window based on the current codex-chatgpt model.

Sub-Agents

The plugin provides a dedicated sub-agent settings page. This page allows global selection of any provider/model and configuration of thinking depth, sub-agent context, maximum nesting depth, and sub-agent count limit.

Environment Requirements

The environment requirements are:

  1. Windows or Linux;
  2. DSH installed;
  3. Node.js and npm;
  4. Windows requires Windows PowerShell for CurrentUser DPAPI usage;
  5. Linux requires the host user to have a writable ~/.dsh or $DSH_HOME, with credential files using 0600 permissions and directories using 0700 permissions.

Linux credential files have no application-layer encryption and rely on file and directory permissions for isolation; do not copy, print, or submit this file. Windows credential files can only be decrypted by the user who created them via DPAPI.

Installation

Via DSH CLI

If dsh is installed globally, you can run:

dsh plugin --profile web add @eddyskywalker/dsh-chatgpt-subscription

Alternatively, you can use npx:

npx @deepseek-ai/dsh plugin --profile web add @eddyskywalker/dsh-chatgpt-subscription

Via DSH Plugin Marketplace

  1. Open the plugin marketplace in the DSH interface.
  2. Search for @eddyskywalker/dsh-chatgpt-subscription or dsh-chatgpt-subscription.
  3. Click install.

Local Source Debugging

To debug from source, you can clone the repository and build:

git clone https://github.com/Aa728848/dsh-chatgpt-subscription.git
cd dsh-chatgpt-subscription
npm install
npm run build

After building, add the local link path to DSH via npx.

Activation

After installation, follow these steps to activate:

  1. Restart dsh web.
  2. Open Settings → Codex Subscription.
  3. Complete ChatGPT login.
  4. Perform Test Connection.
  5. Select Codex (ChatGPT Subscription) in the model selector.
  6. If you need to adjust sub-agents, open the dedicated sub-agent settings page and configure sub-agent models, thinking depth, sub-agent context, maximum nesting depth, and count limit.

Route Interface

The plugin routes are prefixed with /api/dsh-chatgpt-subscription, providing status, login, logout, refresh, test connection, and preference update interfaces.

Uninstallation and Credential Cleanup

Before uninstalling, it is recommended to click Logout in the settings page. This operation will delete the credentials for the current platform and the quota cache in host memory.

Use Cases and Considerations

This plugin is suitable for developers who already have a ChatGPT subscription and wish to integrate Gpt series models into DSH. Note the following:

  1. The plugin runs with the permissions of the current DSH process and accesses models using the current host user’s ChatGPT OAuth login state; before installation, it is recommended to review the source code and repository license.
  2. Linux credential files have no application-layer encryption and rely on 0600 file and 0700 directory permissions for isolation; do not copy, print, or submit this file.
  3. Windows credential files can only be decrypted by the user who created them via DPAPI.
  4. The actual models available on an account are determined by the ChatGPT plan, workspace policy, and upstream compatibility status.

Conclusion

This plugin streamlines the process of integrating ChatGPT subscription into DSH into installation, login, test connection, provider selection, and maintaining search, quota, and sub-agent configuration in the settings page. The repository address is:

https://github.com/Aa728848/dsh-chatgpt-subscription