nzfern/dsh-codex-auth
DeepSeek Harness plugin: run models on your ChatGPT (Codex) quota — one-click Ch
Runs models in DeepSeek Harness using your ChatGPT (Codex) subscription quota: one-click ChatGPT login in the UI (Settings → General card → "Log in with ChatGPT", authorize in the browser with the device code), automatic access-token refresh, and a passive floating remaining-quota badge (Codex remaining xx% plus the reset date/time, colour-coded green/orange/red and toggleable in settings). It also shows your ChatGPT plan (plus/pro/…) and per-window remaining quota (fast window / daily window) via the official WHAM usage endpoint, and ships CLI commands codex-login / codex-status / codex-logout plus standalone scripts that work without a GUI.
Install
dsh plugin --profile web add github:nzfern/dsh-codex-authREADME recommended install: 1) make sure pnpm is available once (npm install -g pnpm); 2) install the plugin into the web profile with the github: form (pnpm fetches from GitHub and registers the bundle); 3) activate the provider under llm-pi-ai.providers in $DSH_HOME/settings.yaml by adding openai-codex: apiKeyEnv: OPENAI_CODEX_ACCESS_TOKEN, then restart dsh web. A one-liner PowerShell installer is also documented, as is a fully manual install (clone/download into the profile's plugin directory, register as a bundle, add the same settings.yaml block, restart).
Compatibility
DSH web profile. Uses ChatGPT (Codex) plus the subscription quota you already have — no OpenAI API key needed. The plugin checks every 30s and swaps a fresh access token from the refresh token before expiry; plan and per-window quota come from the official WHAM usage endpoint.
Details
- Repo: nzfern/dsh-codex-auth
- Category: Coding & Development
- Stars: 0
- Version: GitHub install (README documents repo/one-liner install; no npm release claimed — only a GitHub release badge)
- Last push: 2026-08-14
- First seen: 2026-08-14
Recent updates
README documents the CLI login flow (node "$env:USERPROFILE\.dsh\...") as an alternative to the Web UI card, which flips to "Connected" after the device-code authorization at https://auth.openai.com/codex/device.
FAQ
- How do I install dsh-codex-auth?
- Run dsh plugin --profile web add github:nzfern/dsh-codex-auth (after making pnpm available), then add openai-codex: apiKeyEnv: OPENAI_CODEX_ACCESS_TOKEN under llm-pi-ai.providers in $DSH_HOME/settings.yaml and restart dsh web.
- Does dsh-codex-auth need an OpenAI API key?
- No — it runs models on your ChatGPT (Codex) subscription quota. You log in with ChatGPT once through the device-code flow, and the plugin refreshes the access token automatically.
- Can I check my remaining Codex quota?
- Yes — a passive floating badge shows Codex remaining xx% with the reset date/time, and the settings card shows your plan and per-window remaining quota from the official WHAM usage endpoint.