README
dsh-openai-oauth
OpenAI OAuth for DeepSeek Harness
English | 中文
Sign in to ChatGPT from DeepSeek Harness and use available Codex models without an OpenAI API key or Codex CLI. The plugin keeps the standard DSH sessions, tools, permissions, and model selector.
Features
- Browser login with PKCE or Device Code login
- Web settings and a headless login command
- Automatic token refresh
- Models and reasoning levels discovered from the signed-in account’s Codex catalog
- Codex native web search through ChatGPT OAuth, without a DeepSeek API key
- Credentials stored locally under the Harness home
Requirements
- DeepSeek Harness
0.2.1-rc.5 - Node.js
^22.19.0or>=24.0.0 pnpmonPATH- A ChatGPT account with Codex access
Version 0.3.0 supports macOS and Linux. Windows support is not included yet.
When upgrading from plugin 0.1.x, upgrade DSH first, reinstall the plugin, then restart DSH. Saved OAuth credentials remain in the same location.
Install
Install with an Agent (recommended)
Give this address to an Agent and ask it to follow the runbook:
https://raw.githubusercontent.com/AdonisSheldon/dsh-openai-oauth/main/AGENTS.md
When it finishes, you only need to approve any DSH restart and complete the ChatGPT login yourself.
Install with DSH
After the package is published:
dsh plugin --profile web add dsh-openai-oauth@0.3.0
dsh --profile web --dump-config
Install from the current checkout
pnpm install --frozen-lockfile
pnpm run check
pnpm pack
dsh plugin --profile web add ./dsh-openai-oauth-0.3.0.tgz
dsh --profile web --dump-config
Restart a running DSH Web process after installation.
Login and use
- Open Settings → OpenAI OAuth.
- Choose Browser login or Device Code.
- Sign in with a ChatGPT account that has Codex access.
- Open Models and select an
openai-codexmodel.
Browser login waits for a callback on 127.0.0.1:1455. Use Device Code when that port is unavailable or the browser is on another machine.
For a headless profile:
dsh plugin --profile headless add ./dsh-openai-oauth-0.3.0.tgz
dsh plugin --profile headless exec dsh-openai-login
The command asks which login method to use. Non-interactive terminals must pass --browser or --device-code.
Web search
The bundle selects openai-codex-search through the existing DSH web provider interface, without changing Harness source. After ChatGPT sign-in, ask the Agent to search the web. The standard search tool displays results and source links and records the query and result in the Session. Web fetching keeps the profile's existing fetch provider.
Each query makes an additional Codex model request with the native server-side web_search tool and uses the signed-in ChatGPT account's quota. Queries are sent to OpenAI; the full conversation is not sent. Search and authentication failures are reported directly, without falling back to DeepSeek API access.
Search follows the initiating Session's selected Codex model. Other model routes and calls outside a Session use the first visible model in the account catalog. Search availability depends on OpenAI and the selected model. To pin a search model or change the timeout, merge these settings into the profile's user configuration:
- id: llm-openai-oauth
config:
searchModel: gpt-6.1-sol # Replace with an available model that supports search
searchTimeoutMs: 90000
searchModel is optional. searchTimeoutMs defaults to 90000 milliseconds, with a minimum of 1000. To retain a different search provider, override web.config.searchProvider in the profile's user configuration. Uninstalling restores the original profile selection.
Update and uninstall
dsh plugin --profile web update dsh-openai-oauth
dsh plugin --profile web remove dsh-openai-oauth
Restart DSH after installing, updating, or removing the plugin. Login, logout, and token refresh do not require a restart.
Sign out in Settings → OpenAI OAuth before uninstalling if the stored credential should also be deleted. Uninstalling the package otherwise preserves it.
Notes
- This connects a ChatGPT account to the Codex model provider; it does not create an OpenAI API key.
- The Web integration supports only a local DSH Host bound to
127.0.0.1. - Credentials are stored unencrypted at
$DSH_HOME/plugins/dsh-openai-oauth/credentials.json. - Model availability and quota depend on the signed-in account.
- OpenAI may change the Codex OAuth protocol independently of this plugin.
- This is an unofficial community project and is not affiliated with or endorsed by OpenAI or DeepSeek AI.
See SECURITY.md for security reporting and deployment notes.
更多「整合與分享」外掛
dsh-notification
作者 omdsh-dev
DeepSeek Harness 桌面通知外掛,任務完成時提醒,可按結果與關鍵詞規則控制。
dsh-lark-bot
作者 plutokeating
DeepSeek Harness (dsh) 接入飛書/Lark bot,掃碼即用:流式卡片、專案工作區、並行任務、多角色 Agent、跨會話通知、對話內模型/金鑰管理與安全網守護(dsh 崩潰後飛書仍可自救)。A scan-to-connect bridge bot connecting DeepSeek Harness (dsh) into Feishu/Lark: streaming cards, workspaces, parallel tasks, multi-role agents, cross-session notify, in-chat model/key management, and a safety-net guardian.
dsh-session-notification
作者 dingyi222666
為 Deepseek Harness 提供會話完成等四種狀態的通知響應,支援瀏覽器提示和提示詞
dsh-chatgpt-web
作者 wlv-zedd
將標準 ChatGPT Web 直接橋接到 DeepSeek Harness 的 DSH ChatGPT Free 外掛。
