Preface¶

Running agents in DeepSeek Harness (DSH) typically involves assembling models, tools, and networking capabilities through separate plugins. If you already have an OpenAI ChatGPT or Codex subscription, but still need to configure API keys individually and find separate solutions for GPT conversations, image generation, and web search, the integration cost can be high.

The @wnjxyk/dsh-codex-oauth plugin introduced here uses OAuth login for subscription accounts, integrating GPT models, image generation, web_search, and quota queries into DSH’s native interface. Maintained by WNJXYK, it is categorized under “Model Inference” in the SkillHub community directory. The GitHub repository WNJXYK/dsh-codex-oauth currently has about 14 stars and 4 forks, with an MIT license. The plugin has been verified on DSH 0.1.0-rc.6, with an npm package version of 0.4.2, and requires Node.js >= 20 for the runtime environment.

What Is This¶

dsh-codex-oauth is a unified OpenAI Codex subscription plugin for the DSH web interface. It binds ChatGPT/Codex accounts via OAuth, activates DSH’s built-in openai-codex model provider, and dynamically loads available GPT models based on account permissions. It also registers image generation tools and web search capabilities, and displays subscription plans, remaining quotas, and reset times in the interface.

SkillHub directory page: https://www.skillhub.cn/plugins/WNJXYK/dsh-codex-oauth. SkillHub is a community directory for Skills/plugins and has no official affiliation with DeepSeek or High-Flyer. Installation and documentation should refer to the GitHub README.

Core Features¶

GPT Models¶

The plugin activates DSH’s built-in openai-codex provider, discovers available GPT models from the subscription account, and provides dedicated controls in the DSH model selector. Chat models are dynamically loaded from the openai-codex model source provided by DSH’s built-in llm-pi-ai plugin, eliminating the need to manually maintain a model list.

Image Generation¶

It registers the generate_image tool, supporting multiple sizes and quality tiers, with generation results previewed in the chat interface. The image generation orchestration defaults to using the Codex Power model gpt-5.6-sol, with actual rendering handled by the hosted GPT Image (image_generation) tool.

Web Search¶

It routes DSH’s native web_search to hosted GPT search, returning answer text and structured citations with source URLs. The default search model is also gpt-5.6-sol, aligning with the Codex Power configuration in the README.

Subscription Quota and OAuth¶

The interface allows viewing plan types, remaining quotas, reset times, and window limits (e.g., 5-hour, weekly), with data sourced from https://chatgpt.com/backend-api/wham/usage. OAuth supports browser login and headless device code authorization, including automatic renewal, state refresh, and logout; credentials are saved by default to $DSH_HOME/codex-oauth.json.

Interface Integration¶

The plugin injects into DSH’s client runtime and UI modules such as settings, chat, and tools, following DSH’s Chinese/English and Light/Dark/System themes, and adhering to DSH’s hot-pluggable plugin design.

Installation and Enabling¶

The DSH ecosystem follows the “everything is a plugin” philosophy; web-side installation requires the --profile web and -w parameters. You can choose either npm or GitHub source.

Install the latest version from npm:

dsh plugin --profile web add -w @wnjxyk/dsh-codex-oauth@latest

Install from GitHub:

dsh plugin --profile web add -w github:WNJXYK/dsh-codex-oauth

Uninstall (same for npm and GitHub installations):

dsh plugin --profile web remove -w @wnjxyk/dsh-codex-oauth

After installation, complete the OAuth login in DSH settings or via the plugin’s control entry; in a headless environment, you can use the device code flow (the README includes a headless login example).

Typical Usage and Configuration¶

Default Usage¶

Most scenarios require no additional configuration. After successful login, select the available GPT models from the model selector to start a chat; for image generation or web search, trigger generate_image and web_search through tool calls in DSH chat.

Model visibility and feature toggles are saved in $DSH_HOME/codex-oauth-preferences.json and can be adjusted in the plugin interface.

Advanced Cordis Configuration¶

If you need to customize the credential path, OAuth issuer, or local callback port, you can insert the plugin into Cordis and pass a config. The following example from the README shows customizing the DSH home directory, credential file path, and web search model:

- insert:
    - id: dsh-codex-oauth
      name: "@wnjxyk/dsh-codex-oauth"
      config:
        dshHome: /data/dsh
        path: /secure/codex-oauth.json
        preferencesPath: /secure/codex-oauth-preferences.json
        issuer: https://auth.openai.com
        usageUrl: https://chatgpt.com/backend-api/wham/usage
        controlPort: 1456
        redirectPort: 1455

    - id: codex-web-search
      name: "@wnjxyk/dsh-codex-oauth/web-search"
      config:
        model: gpt-5.6-sol

Common configuration items:

Use Cases and Considerations¶

Who It’s For¶

• Those with ChatGPT/Codex subscriptions who want to use GPT conversations, image generation, and web search uniformly within the DSH web interface;
• Those who need to check subscription quotas and reset windows in DSH to avoid overuse;
• Those who want to complete OAuth via device code on a headless server and then use the same capabilities in DSH.

Risks and Permissions¶

The README clearly states that the project is built on open-source software and relies on non-public ChatGPT Codex backend interfaces. Changes to OpenAI’s protocols may temporarily disable functionality, requiring plugin updates; there is also a low risk of account restrictions, so assess before use.

The plugin runs with the current DSH process permissions, and OAuth credentials are written to host files. Before installation, read the GitHub source code and MIT license to ensure the credential path, loopback ports (default 1455/1456), and deployment environment match.

Conclusion¶

@wnjxyk/dsh-codex-oauth consolidates GPT models, image generation, web search, and quota queries from the OpenAI subscription side into a single OAuth flow in DSH, making it ideal for subscribed developers who want to use Codex capabilities natively within the Harness. Directory and source code:

• SkillHub: https://www.skillhub.cn/plugins/WNJXYK/dsh-codex-oauth
• GitHub: https://github.com/WNJXYK/dsh-codex-oauth