Player-MINEPIG/dsh-llm-codex-oauth
60Last commit Aug 14, 2026
dsh-llm-codex-oauth DSH plugin
This plugin integrates OpenAI Codex OAuth into DeepSeek Harness (DSH), allowing you to use your ChatGPT Plus/Pro/Business/Edu subscription as a model provider. It uses device-code OAuth flow to authenticate with chatgpt.com and exposes the subscription models under the 'codex-oauth' provider. Credentials are stored securely in DSH's credential store.
How to install the dsh-llm-codex-oauth DSH plugin
dsh plugin --profile web add file:/path/to/dsh-llm-codex-oauthCopying does not run this command. Review the repository and version before installing the dsh-llm-codex-oauth DSH plugin.
dsh-llm-codex-oauth DSH plugin data source
dsh-llm-codex-oauth DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-llm-codex-oauth DSH plugin can do
- Registers the `openai-codex` provider as `codex-oauth` in DSH LLM seam, making subscription models available.
- Supports device-code OAuth login via `auth.openai.com` without a local callback server.
- Stores refresh and access tokens in DSH's credential store (`$DSH_HOME/.credentials.yaml`) with 0600 permissions.
- Provides a settings page section with login/logout buttons and real-time status.
- Supports multi-turn conversation with full replay metadata.
- Includes read-only commands `/codex-status` and `/codex-logout` in the chat interface.
Where the dsh-llm-codex-oauth DSH plugin fits
- Use your ChatGPT Plus subscription models in DSH for assistant conversations.
- Switch between multiple model providers in DSH settings after logging in with your ChatGPT account.
- Securely manage OAuth tokens without exposing them in configuration files or logs.
- Develop and test DSH plugins that rely on ChatGPT Codex API endpoints.
Who the dsh-llm-codex-oauth DSH plugin is for
- DSH users who have a ChatGPT Plus/Pro/Business/Edu subscription.
- Developers who want to integrate ChatGPT models into DSH workflows without using official API keys.
dsh-llm-codex-oauth DSH plugin limitations
- This plugin uses the unofficial `chatgpt.com/backend-api` endpoint, which violates OpenAI's terms of service and may lead to account restrictions.
- Image input is not supported currently.
- Model availability depends on the pi-ai package version installed.
- Login state (device code) is only held in process memory; after restart, credentials are re-validated from the credential store.
dsh-llm-codex-oauth DSH plugin: from the repository README
Quoted from the Player-MINEPIG/dsh-llm-codex-oauth README, the upstream source of the dsh-llm-codex-oauth DSH plugin. Copyright remains with the original authors.
> 本项目由 DeepSeek-V4-Pro 在 DeepSeek Harness 用时约 3h 不到完成，未进行完整 Code Review，仅人工审查确保基础功能可用，使用前需了解安全风险并自行为此负责。 在 dsh（DeepSeek Harness）里使用你的 **ChatGPT / Codex 订阅**（Plus / Pro / Business / Edu）。插件通过 OpenAI Codex 的 OAuth 流程登录 ChatGPT 账号，把订阅额度暴露成 dsh 的 `codex-oauth` 模型提供方。 > ⚠️ **风险提示**：本插件调用 ChatGPT 网页版后端（`chatgpt.com/backend-api`），这是一个未公开、官方不支持的接口，违反 OpenAI 服务条款的风险真实存在，可能导致账号受限。请自行评估后使用。 ## 目录 - [dsh-llm-codex-oauth](#dsh-llm-codex-oauth) - [目录](#目录) - [功能特性](#功能特性) - [安装](#安装) - [免 pnpm 的一键安装（本地 / 开发用，跨平台）](#免-pnpm-的一键安装本地--开发用跨平台) - [手动命令行安装](#手动命令行安装) - [验证安装完成](#验证安装完成) - [使用](#使用) - [工作原理](#工作原理) - [开发](#开发) - [安全与合规](#安全与合规) - [License](#license) ## 功能特性 - **订阅模型接入**：把 pi-ai 内置的 `openai-codex` provider（`openai-codex-responses` 线上协议）注册为 dsh LLM seam 的 `codex-oauth` 提供方；模型目录随所装 pi-ai 维护（如 `gpt-5.3-codex-spark`、`gpt-5.4`、`gpt-5.5`、`gpt-5.6-*` 等）。 - **OAuth 设备码登录**：走 `auth.openai.com`（与 Codex CLI 同一 OAuth client），headless 友好，无需本地回调服务器。 - **凭据安全**：refresh / access token 只存在 dsh 凭据库 `$DSH_HOME/.credentials.yaml`（0600），**不进配置、不进会话日志、不进本仓库**；access token 过期时由 pi-ai 在串行化的写路径里自动用 refresh token 续期。 - **设置页登录**：在设置页提供「Codex 订阅 (ChatGPT)」区块，含登录 / 登出按钮与实时状态；对话侧仅保留
Read the full READMERepository license: MIT
dsh-llm-codex-oauth DSH plugin questions
How do I install the dsh-llm-codex-oauth plugin?
You can install using the one-click script: run `node scripts/install.mjs` from the repository root. This works on Windows, macOS, and Linux without needing pnpm. Alternatively, use the manual command: `dsh plugin --profile web add file:/path/to/dsh-llm-codex-oauth` after installing pnpm and dsh CLI.
How do I log in with my ChatGPT account?
After installing and restarting dsh, open the settings page and select 'Codex Subscription (ChatGPT)' from the sidebar. Click 'Log in to ChatGPT account', then visit the displayed URL, enter the device code, and log in with your ChatGPT credentials. The status will change to 'Connected' once successful.
What are the risks of using this plugin?
This plugin interfaces with the unofficial `chatgpt.com/backend-api`, which is not supported by OpenAI and violates their terms of service. Your account could be restricted or banned. Use at your own risk. The plugin does not store your credentials in the repository, but the risk remains.
Can I use this plugin with a free ChatGPT account?
The plugin is designed for ChatGPT Plus, Pro, Business, or Edu subscriptions. Free accounts may not have access to the Codex endpoints used by this plugin. You need a paid subscription to use the models exposed via the 'codex-oauth' provider.
How do I update the plugin after installation?
Stop the dsh process, then run the one-click install script again from the repository: `node scripts/install.mjs`. This will refresh the plugin files in place without affecting credentials. If you used pnpm, you must first remove and re-add the plugin: `dsh plugin --profile web remove dsh-llm-codex-oauth` then `dsh plugin --profile web add file:/path/to/dsh-llm-codex-oauth`.